@seojeom/mcp-server

Seojeom MCP Server

Local-first MCP server for Claude and Codex.

@seojeom/mcp-server binds to the project currently opened by the Seojeom desktop app or Godot launcher through a shared registry directory, then serves that project's local wiki and graph data over stdio.

Quickstart

Claude Code

claude mcp add -s local \
  -e SEOJEOM_SHARED_REGISTRY_DIR=/mnt/c/Users/<you>/.seojeom/registry \
  seojeom -- npx -y @seojeom/mcp-server \
  --router \
  --host-kind auto \
  --approval-mode prompt

Claude Desktop

Add this to claude_desktop_config.json and restart Claude Desktop:

{
  "mcpServers": {
    "seojeom": {
      "command": "npx",
      "env": {
        "SEOJEOM_SHARED_REGISTRY_DIR": "<shared-registry-dir>"
      },
      "args": [
        "-y",
        "@seojeom/mcp-server",
        "--router",
        "--host-kind", "auto",
        "--approval-mode", "prompt"
      ]
    }
  }
}

Print the exact onboarding command first

npx -y @seojeom/mcp-server --print-claude-onboarding

What it provides

• project binding to the currently active desktop/Godot project
• local wiki read/search/write tools
• local graph read/search/query tools
• workflow and session-planning helpers for authoring tasks
• approval-gated mutating operations

The exact tool surface is discovered at runtime through MCP tools/list.

Runtime contract

• primary transport: stdio
• primary install path: npx -y @seojeom/mcp-server
• recommended mode: shared-registry router mode
• expected runtime: Node >=20.20.0

Notes

• This package is still a preview release and the tool surface may evolve between versions.
• Router mode is the recommended public path. Direct per-project standalone flags remain as a compatibility fallback.
• Public package documentation intentionally stays focused on installation and end-user usage. Internal release automation and repository-specific operator workflows are not part of the package contract.

Links

• Repository: https://github.com/seojeom/seojeom-mcp
• Issues: https://github.com/seojeom/seojeom-mcp/issues
• License: MIT