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;
|
|
|
|
|
}
|