ktx/packages/context/src/mcp/server.ts

31 lines
895 B
TypeScript
Raw Normal View History

2026-05-10 23:12:26 +02:00
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
feat(setup): add Claude Desktop target and MCP-first agent setup (#114) * feat(setup): add Claude Desktop target and MCP-first agent setup Adds `ktx mcp stdio` and a `claude-desktop` setup target that generates a local plugin ZIP wiring the analytics skill and a stdio MCP config. Replaces the CLI-only agent install mode with MCP+analytics (default) and an optional admin CLI skill, renames the research skill to analytics, and lets interactive setup pick project vs global scope when every target supports it. Extracts a shared MCP server factory used by both HTTP and stdio entrypoints. * Add MCP agent client setup support * Polish setup output formatting * Add MCP tool polish design spec Design for slimming the MCP-registered surface from 25 to 11 tools, introducing memory_ingest, applying the per-tool polish kit (annotations, outputSchema, .describe(), in-band error wrapping, union-drift fixes, type-narrowed jsonToolResult), emitting progress notifications on sql_execution + sl_query, and refining the ktx-analytics SKILL.md to match. * Refine MCP tool polish design spec after adversarial review iteration 1 * Refine MCP tool polish design spec after adversarial review iteration 2 * Refine MCP tool polish design spec after adversarial review iteration 3 * refactor(context): rename memory capture service to ingest * feat(mcp): slim research tool surface * refactor(mcp): remove admin ports from server factory * refactor(cli): rename text ingest memory port * docs: update analytics skill for memory ingest * chore: verify mcp surface rename * Add MCP tool polish v1 surface change plan * feat(context): polish mcp tool metadata * fix(context): enforce resolved semantic layer compute sources * feat(context): emit mcp query progress stages * fix(context): keep mcp progress event internal * Add MCP tool polish v1 metadata & progress plan * Fix CI snapshot and docs checks
2026-05-16 11:39:55 +02:00
import { registerKtxContextTools } from './context-tools.js';
import type { KtxMcpServerDeps, KtxMcpServerLike } from './types.js';
2026-05-10 23:12:26 +02:00
2026-05-10 23:51:24 +02:00
export function createKtxMcpServer(deps: KtxMcpServerDeps): KtxMcpServerDeps['server'] {
2026-05-10 23:12:26 +02:00
if (deps.contextTools) {
2026-05-10 23:51:24 +02:00
registerKtxContextTools({
2026-05-10 23:12:26 +02:00
server: deps.server,
ports: deps.contextTools,
userContext: deps.userContext,
});
}
return deps.server;
}
2026-05-10 23:51:24 +02:00
export function createDefaultKtxMcpServer(
deps: Omit<KtxMcpServerDeps, 'server'> & { name?: string; version?: string },
2026-05-10 23:12:26 +02:00
): McpServer {
const server = new McpServer({
2026-05-10 23:51:24 +02:00
name: deps.name ?? 'ktx',
2026-05-10 23:12:26 +02:00
version: deps.version ?? '0.0.0-private',
});
2026-05-10 23:51:24 +02:00
createKtxMcpServer({
server: server as KtxMcpServerLike,
2026-05-10 23:12:26 +02:00
userContext: deps.userContext,
contextTools: deps.contextTools,
});
return server;
}