seojeom-mcp 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seojeom
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# Seojeom MCP Server
+
+Local-first MCP server for Claude and Codex.
+
+`seojeom-mcp` 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
+
+```bash
+claude mcp add -s local \
+  -e SEOJEOM_SHARED_REGISTRY_DIR=/mnt/c/Users/<you>/.seojeom/registry \
+  seojeom -- npx -y seojeom-mcp \
+  --router \
+  --host-kind auto \
+  --approval-mode prompt
+```
+
+### Claude Desktop
+
+Add this to `claude_desktop_config.json` and restart Claude Desktop:
+
+```json
+{
+  "mcpServers": {
+    "seojeom": {
+      "command": "npx",
+      "env": {
+        "SEOJEOM_SHARED_REGISTRY_DIR": "<shared-registry-dir>"
+      },
+      "args": [
+        "-y",
+        "seojeom-mcp",
+        "--router",
+        "--host-kind", "auto",
+        "--approval-mode", "prompt"
+      ]
+    }
+  }
+}
+```
+
+### Print the exact onboarding command first
+
+```bash
+npx -y seojeom-mcp --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
+- core graph mutation/proposal tools for local 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`
+- recommended mode: shared-registry router mode
+- expected runtime: Node `>=20.20.0`
+- public npm package shape: standalone stdio entrypoint only
+
+## Registry
+
+- MCP Registry identifier target: `io.github.seojeom/seojeom-mcp`
+- planned publish mode: GitHub Actions Trusted Publishing + `npm publish --provenance`
+
+## 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.
+- The public package defaults to a core authoring tool surface. Prompts, resources, and more specialized orchestration surfaces are reserved for non-public/internal profiles.
+- 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

package/bin/seojeom-mcp

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/standalone.js";