26 lines
1.1 KiB
Markdown
26 lines
1.1 KiB
Markdown
# packages/mcp-server
|
|
|
|
## Scope
|
|
|
|
- This package is the MCP/JSON-RPC adapter over the API server.
|
|
- `src/protocol/tools.ts` defines tool schemas.
|
|
- `src/protocol/handler.ts` maps tool calls to API requests and JSON-RPC responses.
|
|
- `src/protocol/metadata.ts` exposes discovery metadata and protocol versioning.
|
|
|
|
## Keep In Sync
|
|
|
|
- Tool definitions, handler argument mapping, and server metadata must stay consistent.
|
|
- When adding or renaming a tool, update `tools.ts` and `handler.ts` together.
|
|
- If protocol version or server-card details change, update both `metadata.ts` and initialize responses in `handler.ts`.
|
|
|
|
## Protocol Rules
|
|
|
|
- Use MCP/JSON-RPC error codes and response envelopes, not ad-hoc API-style payloads.
|
|
- Keep this layer transport-focused. Marketplace behavior belongs in `packages/core`; HTTP semantics belong in `packages/api-server`.
|
|
- Preserve the current tool result shape unless the protocol contract is being changed deliberately: text content with JSON-stringified API results.
|
|
|
|
## Verify
|
|
|
|
- `bun run --cwd packages/mcp-server build`
|
|
- `bun run ci`
|