seojeom-mcp 0.3.18 → 0.3.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +57 -0
- package/dist/standalone.js +136 -98
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
# Seojeom MCP Server
|
|
2
2
|
|
|
3
|
+
Canonical repo location: `packages/seojeom-mcp`
|
|
4
|
+
|
|
5
|
+
During the Godot-only decommission transition, `apps/desktop/mcp-server` may already be absent. New work should treat this package path as the source of truth. If a deprecated local lane still needs the old path to exist, recreate the minimal metadata-wrapper with `pnpm apply:legacy-compat-wrapper`.
|
|
6
|
+
|
|
3
7
|
Local-first MCP server for Claude and Codex.
|
|
4
8
|
|
|
5
9
|
`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.
|
|
@@ -68,6 +72,59 @@ The exact tool surface is discovered at runtime through MCP `tools/list`.
|
|
|
68
72
|
- expected runtime: Node `>=20.20.0`
|
|
69
73
|
- public npm package shape: standalone stdio entrypoint only
|
|
70
74
|
|
|
75
|
+
## Source build contract
|
|
76
|
+
|
|
77
|
+
Running `pnpm build` in this package is a dual-output build:
|
|
78
|
+
|
|
79
|
+
- `dist/index.js` and the rest of `dist/**` stay available as the local source/runtime HTTP sidecar surface used by Godot and other repo-local lanes
|
|
80
|
+
- `.public-package/dist/standalone.js` is the staged npm publish surface
|
|
81
|
+
|
|
82
|
+
After a successful build, you can verify both lanes with:
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
pnpm smoke:build-layout
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Godot-side source verification can also run the local HTTP sidecar smoke directly from the canonical package root:
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
pnpm smoke:sidecar-health
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
## Surface tiers
|
|
95
|
+
|
|
96
|
+
`seojeom-mcp` is not one uniform surface. Treat these as separate contracts:
|
|
97
|
+
|
|
98
|
+
### 1. npm public package
|
|
99
|
+
|
|
100
|
+
- audience: external Claude/Codex users installing from npm
|
|
101
|
+
- transport: `stdio`
|
|
102
|
+
- mode: shared-registry router
|
|
103
|
+
- published shape: `LICENSE`, `README.md`, `bin/seojeom-mcp`, `dist/standalone.js`, `package.json`
|
|
104
|
+
- capability promise: public tools only
|
|
105
|
+
- non-goals: internal prompts, internal resources, full authoring harness, desktop UI shell
|
|
106
|
+
|
|
107
|
+
This is the only contract guaranteed by the published npm package.
|
|
108
|
+
|
|
109
|
+
### 2. local full runtime
|
|
110
|
+
|
|
111
|
+
- audience: local maintainers running from source
|
|
112
|
+
- transport: stdio plus local sidecar HTTP runtime paths
|
|
113
|
+
- profile: full authoring surface
|
|
114
|
+
- includes: prompts, resources, specialized graph/wiki authoring flows, internal playbooks
|
|
115
|
+
|
|
116
|
+
This source-tree runtime is intentionally larger than the public package.
|
|
117
|
+
|
|
118
|
+
### 3. desktop-coupled runtime
|
|
119
|
+
|
|
120
|
+
- audience: local desktop/Godot-integrated operation
|
|
121
|
+
- product default: app-bundled sidecar runtime
|
|
122
|
+
- depends on: shared registry writer, approval queue UI, review shell, sidecar health surface
|
|
123
|
+
- examples: approval review pane, desktop approval alerts, graph IPC bearer-token flows
|
|
124
|
+
- debug override: sidecar entry override is reserved for debug-only startup paths
|
|
125
|
+
|
|
126
|
+
These desktop-coupled capabilities are not part of the standalone npm guarantee.
|
|
127
|
+
|
|
71
128
|
## Registry
|
|
72
129
|
|
|
73
130
|
- MCP Registry identifier target: `io.github.seojeom/seojeom-mcp`
|