@nativemind108/mcp 0.0.0-stage → 1.0.0
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/CHANGELOG.md +5 -0
- package/LICENSE +289 -0
- package/NOTICE +5 -0
- package/README.md +29 -2
- package/dist/cjs/catalog.d.ts +21 -0
- package/dist/cjs/catalog.js +54 -0
- package/dist/cjs/catalog.js.map +1 -0
- package/dist/cjs/client.d.ts +59 -0
- package/dist/cjs/client.js +107 -0
- package/dist/cjs/client.js.map +1 -0
- package/dist/cjs/define.d.ts +37 -0
- package/dist/cjs/define.js +26 -0
- package/dist/cjs/define.js.map +1 -0
- package/dist/cjs/feedback.d.ts +21 -0
- package/dist/cjs/feedback.js +77 -0
- package/dist/cjs/feedback.js.map +1 -0
- package/dist/cjs/http.d.ts +15 -0
- package/dist/cjs/http.js +192 -0
- package/dist/cjs/http.js.map +1 -0
- package/dist/cjs/hub.d.ts +42 -0
- package/dist/cjs/hub.js +284 -0
- package/dist/cjs/hub.js.map +1 -0
- package/dist/cjs/index.d.ts +10 -0
- package/dist/cjs/index.js +28 -0
- package/dist/cjs/index.js.map +1 -0
- package/dist/cjs/options.d.ts +119 -0
- package/dist/cjs/options.js +3 -0
- package/dist/cjs/options.js.map +1 -0
- package/dist/cjs/output.d.ts +23 -0
- package/dist/cjs/output.js +88 -0
- package/dist/cjs/output.js.map +1 -0
- package/dist/cjs/package.json +3 -0
- package/dist/cjs/service.d.ts +33 -0
- package/dist/cjs/service.js +64 -0
- package/dist/cjs/service.js.map +1 -0
- package/dist/cjs/tools.d.ts +31 -0
- package/dist/cjs/tools.js +124 -0
- package/dist/cjs/tools.js.map +1 -0
- package/dist/esm/catalog.d.ts +22 -0
- package/dist/esm/catalog.d.ts.map +1 -0
- package/dist/esm/catalog.js +50 -0
- package/dist/esm/catalog.js.map +1 -0
- package/dist/esm/client.d.ts +60 -0
- package/dist/esm/client.d.ts.map +1 -0
- package/dist/esm/client.js +102 -0
- package/dist/esm/client.js.map +1 -0
- package/dist/esm/define.d.ts +38 -0
- package/dist/esm/define.d.ts.map +1 -0
- package/dist/esm/define.js +22 -0
- package/dist/esm/define.js.map +1 -0
- package/dist/esm/feedback.d.ts +22 -0
- package/dist/esm/feedback.d.ts.map +1 -0
- package/dist/esm/feedback.js +73 -0
- package/dist/esm/feedback.js.map +1 -0
- package/dist/esm/http.d.ts +16 -0
- package/dist/esm/http.d.ts.map +1 -0
- package/dist/esm/http.js +185 -0
- package/dist/esm/http.js.map +1 -0
- package/dist/esm/hub.d.ts +43 -0
- package/dist/esm/hub.d.ts.map +1 -0
- package/dist/esm/hub.js +275 -0
- package/dist/esm/hub.js.map +1 -0
- package/dist/esm/index.d.ts +11 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +12 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/options.d.ts +120 -0
- package/dist/esm/options.d.ts.map +1 -0
- package/dist/esm/options.js +2 -0
- package/dist/esm/options.js.map +1 -0
- package/dist/esm/output.d.ts +24 -0
- package/dist/esm/output.d.ts.map +1 -0
- package/dist/esm/output.js +79 -0
- package/dist/esm/output.js.map +1 -0
- package/dist/esm/service.d.ts +34 -0
- package/dist/esm/service.d.ts.map +1 -0
- package/dist/esm/service.js +60 -0
- package/dist/esm/service.js.map +1 -0
- package/dist/esm/tools.d.ts +32 -0
- package/dist/esm/tools.d.ts.map +1 -0
- package/dist/esm/tools.js +118 -0
- package/dist/esm/tools.js.map +1 -0
- package/package.json +59 -4
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.isCallToolResult = isCallToolResult;
|
|
4
|
+
exports.defineTool = defineTool;
|
|
5
|
+
const zod_1 = require("zod");
|
|
6
|
+
// generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
|
|
7
|
+
function isCallToolResult(value) {
|
|
8
|
+
return !!value && typeof value === 'object' && Array.isArray(value.content);
|
|
9
|
+
}
|
|
10
|
+
// generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
|
|
11
|
+
/** A tool with a zod input shape (as Konsilium's `server.registerTool`); JSON Schema for tools/list via z.toJSONSchema. */
|
|
12
|
+
function defineTool(def) {
|
|
13
|
+
const schema = zod_1.z.object(def.input);
|
|
14
|
+
const json = zod_1.z.toJSONSchema(schema, { target: 'draft-2020-12', io: 'input' });
|
|
15
|
+
delete json.$schema;
|
|
16
|
+
return {
|
|
17
|
+
name: def.name,
|
|
18
|
+
title: def.title,
|
|
19
|
+
description: def.description,
|
|
20
|
+
inputSchema: { ...json, type: 'object' },
|
|
21
|
+
...(def.annotations ? { annotations: def.annotations } : {}),
|
|
22
|
+
parse: (args) => schema.parse(args ?? {}),
|
|
23
|
+
call: def.call,
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
//# sourceMappingURL=define.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/define.ts"],"names":[],"mappings":";;AAiCA,4CAEC;AAID,gCAoBC;AA3DD,6BAA0C;AAgC1C,kFAAkF;AAClF,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAE,KAA+B,CAAC,OAAO,CAAC,CAAC;AACzG,CAAC;AAED,kFAAkF;AAClF,2HAA2H;AAC3H,SAAgB,UAAU,CAAwB,GAOjD;IACC,MAAM,MAAM,GAAG,OAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,OAAC,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,OAAO,EAAE,CAA4B,CAAC;IACzG,OAAO,IAAI,CAAC,OAAO,CAAC;IACpB,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,WAAW,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAyB;QAC/D,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QACzC,IAAI,EAAE,GAAG,CAAC,IAA8B;KACzC,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { ToolDefinition } from './define.js';
|
|
2
|
+
export declare const FEEDBACK_TOOL_NAMES: readonly ["report_bug", "suggest_improvement", "leave_review", "add_feedback_note", "my_feedback"];
|
|
3
|
+
export type FeedbackToolName = (typeof FEEDBACK_TOOL_NAMES)[number];
|
|
4
|
+
export interface FeedbackToolsOptions {
|
|
5
|
+
/** Product title in descriptions ("Report a bug in dropexpired itself …"). */
|
|
6
|
+
product: string;
|
|
7
|
+
/** API base path of the contract ('/v1', '/api'). */
|
|
8
|
+
basePath: string;
|
|
9
|
+
/** Product wording / extras: title + description per tool. */
|
|
10
|
+
describe?: (tool: FeedbackToolName) => {
|
|
11
|
+
title?: string;
|
|
12
|
+
description?: string;
|
|
13
|
+
} | undefined;
|
|
14
|
+
/** Product extras added to a successful result (Konsilium: `next` thank-you text). */
|
|
15
|
+
decorate?: (tool: FeedbackToolName, data: Record<string, unknown>, lang: string | null) => Record<string, unknown>;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* The five feedback tools. They are registered on every MCP server of every product and cannot be turned off.
|
|
19
|
+
* A product whose API has no storage yet answers 501 → the tool returns isError with a plain message (no exception).
|
|
20
|
+
*/
|
|
21
|
+
export declare function feedbackTools(o: FeedbackToolsOptions): ToolDefinition[];
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.FEEDBACK_TOOL_NAMES = void 0;
|
|
4
|
+
exports.feedbackTools = feedbackTools;
|
|
5
|
+
const api_1 = require("@nativemind108/api");
|
|
6
|
+
const client_js_1 = require("./client.js");
|
|
7
|
+
const output_js_1 = require("./output.js");
|
|
8
|
+
// generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade (tools = Konsilium mcp/feedbacktools.js; requirements AC5)
|
|
9
|
+
exports.FEEDBACK_TOOL_NAMES = ['report_bug', 'suggest_improvement', 'leave_review', 'add_feedback_note', 'my_feedback'];
|
|
10
|
+
const W = { readOnlyHint: false, destructiveHint: false, openWorldHint: false };
|
|
11
|
+
const strip = (s, drop = []) => {
|
|
12
|
+
const properties = { ...(s.properties ?? {}) };
|
|
13
|
+
for (const d of drop)
|
|
14
|
+
delete properties[d];
|
|
15
|
+
const required = (s.required ?? []).filter((r) => !drop.includes(r));
|
|
16
|
+
return { type: 'object', properties, ...(required.length ? { required } : {}) };
|
|
17
|
+
};
|
|
18
|
+
// generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
|
|
19
|
+
/**
|
|
20
|
+
* The five feedback tools. They are registered on every MCP server of every product and cannot be turned off.
|
|
21
|
+
* A product whose API has no storage yet answers 501 → the tool returns isError with a plain message (no exception).
|
|
22
|
+
*/
|
|
23
|
+
function feedbackTools(o) {
|
|
24
|
+
const p = o.product;
|
|
25
|
+
const S = api_1.FEEDBACK_SCHEMAS;
|
|
26
|
+
const path = (k) => `${o.basePath}${api_1.FEEDBACK_PATHS[k].path}`;
|
|
27
|
+
const text = (name, title, description) => ({ title: o.describe?.(name)?.title ?? title, description: o.describe?.(name)?.description ?? description });
|
|
28
|
+
const wrap = (name, run) => async (args, ctx) => {
|
|
29
|
+
try {
|
|
30
|
+
const data = (await run(args, ctx));
|
|
31
|
+
return o.decorate ? o.decorate(name, data, ctx.lang) : data;
|
|
32
|
+
}
|
|
33
|
+
catch (error) {
|
|
34
|
+
if (error instanceof client_js_1.ApiCallError && error.status === 501)
|
|
35
|
+
return (0, output_js_1.errorResult)(error, `${p} does not accept feedback yet (NOT_IMPLEMENTED).`);
|
|
36
|
+
throw error;
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
const post = async (ctx, k, args) => (await ctx.api.request(api_1.FEEDBACK_PATHS[k].method, path(k), args, { 'X-NM-MCP-Client': ctx.client })).body.data;
|
|
40
|
+
return [
|
|
41
|
+
{
|
|
42
|
+
name: 'report_bug',
|
|
43
|
+
...text('report_bug', `Report a ${p} bug`, `Report a bug in ${p} itself (the product: MCP tools, app, API) — not a problem of your own data. Example: a tool returned a wrong error, a result was lost. Becomes an item for the ${p} team.`),
|
|
44
|
+
inputSchema: strip(S.bugInput), annotations: W,
|
|
45
|
+
call: wrap('report_bug', (a, ctx) => post(ctx, 'bug', a)),
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
name: 'suggest_improvement',
|
|
49
|
+
...text('suggest_improvement', `Suggest a ${p} improvement`, `Suggest how to improve ${p} itself, e.g. a missing MCP tool or parameter.`),
|
|
50
|
+
inputSchema: strip(S.improvementInput), annotations: W,
|
|
51
|
+
call: wrap('suggest_improvement', (a, ctx) => post(ctx, 'improvement', a)),
|
|
52
|
+
},
|
|
53
|
+
{
|
|
54
|
+
name: 'leave_review',
|
|
55
|
+
...text('leave_review', `Review ${p}`, `Leave a review of how ${p} itself works for you. Optional rating 1–5.`),
|
|
56
|
+
inputSchema: strip(S.reviewInput), annotations: W,
|
|
57
|
+
call: wrap('leave_review', (a, ctx) => post(ctx, 'review', a)),
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
name: 'add_feedback_note',
|
|
61
|
+
...text('add_feedback_note', 'Add to my feedback', `Add details to feedback I already sent (#F…) instead of sending a new one: the original stays, the addition is kept in its history with the date and is visible to the ${p} team.`),
|
|
62
|
+
inputSchema: { type: 'object', properties: { feedback_id: { type: 'integer' }, text: { type: 'string', minLength: 2, maxLength: 4000 } }, required: ['feedback_id', 'text'] },
|
|
63
|
+
annotations: W,
|
|
64
|
+
call: wrap('add_feedback_note', (a, ctx) => post(ctx, 'note', { id: a.feedback_id, text: a.text })),
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
name: 'my_feedback',
|
|
68
|
+
...text('my_feedback', 'My feedback', `Feedback I sent about ${p} (#F…), newest first, with status and additions — find the item to add to.`),
|
|
69
|
+
inputSchema: strip(S.mineInput), annotations: { readOnlyHint: true, openWorldHint: false },
|
|
70
|
+
call: wrap('my_feedback', async (a, ctx) => {
|
|
71
|
+
const data = (await ctx.api.request('GET', path('mine'), { limit: a.limit ?? 20 })).body.data;
|
|
72
|
+
return { feedback: data.feedback.map((f) => ({ ...f, text: String(f.text ?? '').slice(0, 300) })) };
|
|
73
|
+
}),
|
|
74
|
+
},
|
|
75
|
+
];
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=feedback.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../src/feedback.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { FastifyInstance } from 'fastify';
|
|
2
|
+
import { HubPool } from './hub.js';
|
|
3
|
+
import type { McpRoute, McpServiceOptions } from './options.js';
|
|
4
|
+
export declare const DEFAULT_ROUTE: McpRoute;
|
|
5
|
+
/**
|
|
6
|
+
* Streamable HTTP on fastify (started with core `httpServer.start`). No server-side key: every request carries its own
|
|
7
|
+
* `Authorization: Bearer …`, forwarded to the API. A session is bound to the key (hash), route and params that opened it.
|
|
8
|
+
* `/health` is open; `/.well-known/oauth-protected-resource[/…]` (RFC 9728) when authServers are set.
|
|
9
|
+
*/
|
|
10
|
+
export declare function startHttp(options: McpServiceOptions): Promise<{
|
|
11
|
+
app: FastifyInstance;
|
|
12
|
+
pool: HubPool;
|
|
13
|
+
close: () => Promise<void>;
|
|
14
|
+
sessions: () => number;
|
|
15
|
+
}>;
|
package/dist/cjs/http.js
ADDED
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.DEFAULT_ROUTE = void 0;
|
|
7
|
+
exports.startHttp = startHttp;
|
|
8
|
+
const node_crypto_1 = __importDefault(require("node:crypto"));
|
|
9
|
+
const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
|
|
10
|
+
const sse_js_1 = require("@modelcontextprotocol/sdk/server/sse.js");
|
|
11
|
+
const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
|
|
12
|
+
const core_1 = require("@nativemind108/core");
|
|
13
|
+
const client_js_1 = require("./client.js");
|
|
14
|
+
const hub_js_1 = require("./hub.js");
|
|
15
|
+
// generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade
|
|
16
|
+
exports.DEFAULT_ROUTE = { path: '/mcp' };
|
|
17
|
+
function rpcError(reply, status, message, headers = {}) {
|
|
18
|
+
return reply.code(status).headers(headers).type('application/json').send({ jsonrpc: '2.0', error: { code: -32000, message }, id: null });
|
|
19
|
+
}
|
|
20
|
+
// generated by Claude (Opus 5.5), 2026-11-14; SDD sdd-nativemind-backend-handmade (from dropexpired services/mcp/src/http.ts + PBN mcp http/oauth, node:http → fastify)
|
|
21
|
+
/**
|
|
22
|
+
* Streamable HTTP on fastify (started with core `httpServer.start`). No server-side key: every request carries its own
|
|
23
|
+
* `Authorization: Bearer …`, forwarded to the API. A session is bound to the key (hash), route and params that opened it.
|
|
24
|
+
* `/health` is open; `/.well-known/oauth-protected-resource[/…]` (RFC 9728) when authServers are set.
|
|
25
|
+
*/
|
|
26
|
+
async function startHttp(options) {
|
|
27
|
+
const http = options.transports.http;
|
|
28
|
+
const pool = new hub_js_1.HubPool(options);
|
|
29
|
+
const sessions = new Map();
|
|
30
|
+
const idleMs = http.sessionIdleMs ?? 30 * 60_000;
|
|
31
|
+
const maxSessions = http.maxSessions ?? 5000;
|
|
32
|
+
const routes = options.routes?.length ? options.routes : [exports.DEFAULT_ROUTE];
|
|
33
|
+
const publicUrl = (http.publicUrl ?? `http://${http.host}:${http.port}`).replace(/\/+$/, '');
|
|
34
|
+
const accept = options.acceptToken ?? ((t) => t.length > 0);
|
|
35
|
+
const app = await (0, core_1.createApp)({
|
|
36
|
+
name: options.product.name,
|
|
37
|
+
...(options.logger ? { logger: options.logger } : {}),
|
|
38
|
+
bodyLimit: 4 * 1024 * 1024,
|
|
39
|
+
trustProxy: true,
|
|
40
|
+
health: { check: () => ({ sessions: sessions.size }) },
|
|
41
|
+
});
|
|
42
|
+
const challenge = (path) => ({ 'WWW-Authenticate': `Bearer resource_metadata="${publicUrl}/.well-known/oauth-protected-resource${path.replace(/\/+$/, '')}"` });
|
|
43
|
+
const langOf = (req) => options.langOf ? options.langOf(req.query, req.headers) : (req.query.lang ?? null);
|
|
44
|
+
if (http.authServers?.length) {
|
|
45
|
+
const meta = (path) => ({ resource: `${publicUrl}${path}`, authorization_servers: http.authServers, bearer_methods_supported: ['header'], resource_name: options.product.title });
|
|
46
|
+
app.get('/.well-known/oauth-protected-resource', async () => meta('/mcp'));
|
|
47
|
+
app.get('/.well-known/oauth-protected-resource/*', async (req) => meta(`/${req.params['*']}`));
|
|
48
|
+
}
|
|
49
|
+
async function open(route, req, reply, token, params, make) {
|
|
50
|
+
if (sessions.size >= maxSessions)
|
|
51
|
+
return rpcError(reply, 503, 'Too many MCP sessions; try again later.');
|
|
52
|
+
let hub;
|
|
53
|
+
try {
|
|
54
|
+
hub = await pool.acquire(route.anonymous && !token ? null : token);
|
|
55
|
+
}
|
|
56
|
+
catch (error) {
|
|
57
|
+
if (error instanceof client_js_1.ApiCallError && (error.status === 401 || error.status === 403)) {
|
|
58
|
+
return rpcError(reply, error.status, `${error.code}: ${error.message}`, error.status === 401 ? challenge(req.url.split('?')[0]) : {});
|
|
59
|
+
}
|
|
60
|
+
return rpcError(reply, 502, `The ${options.product.title} API is not reachable; try again later.`);
|
|
61
|
+
}
|
|
62
|
+
const identity = token && options.oauth?.isOAuthToken(token) ? (await options.oauth.identity(hub.client)) ?? undefined : undefined;
|
|
63
|
+
const transport = await make(hub, identity);
|
|
64
|
+
const server = hub.createServer(route, params, langOf(req), true, token ? (0, hub_js_1.keyHash)(token) : null);
|
|
65
|
+
await server.connect(transport);
|
|
66
|
+
return { hub, transport, identity };
|
|
67
|
+
}
|
|
68
|
+
for (const route of routes) {
|
|
69
|
+
const handler = async (req, reply) => {
|
|
70
|
+
const params = (req.params ?? {});
|
|
71
|
+
if (route.accepts && !route.accepts(params))
|
|
72
|
+
return rpcError(reply, 404, 'Unknown MCP endpoint.');
|
|
73
|
+
const path = req.url.split('?')[0];
|
|
74
|
+
const token = (0, core_1.bearerOf)(req.headers.authorization);
|
|
75
|
+
if (token && !accept(token))
|
|
76
|
+
return rpcError(reply, 401, 'Unauthorized: this bearer token is not accepted here.', challenge(path));
|
|
77
|
+
if (!token && !route.anonymous)
|
|
78
|
+
return rpcError(reply, 401, `Unauthorized: connect through OAuth (see WWW-Authenticate) or send "Authorization: Bearer <key>" (an API key of your ${options.product.title} account).`, challenge(path));
|
|
79
|
+
const hash = token ? (0, hub_js_1.keyHash)(token) : null;
|
|
80
|
+
const paramsKey = JSON.stringify(params);
|
|
81
|
+
const sid = req.headers['mcp-session-id'];
|
|
82
|
+
const existing = typeof sid === 'string' ? sessions.get(sid) : undefined;
|
|
83
|
+
if (existing) {
|
|
84
|
+
if (!(existing.transport instanceof streamableHttp_js_1.StreamableHTTPServerTransport))
|
|
85
|
+
return rpcError(reply, 400, 'This session uses the legacy SSE transport.');
|
|
86
|
+
if (existing.keyHash !== hash) {
|
|
87
|
+
const same = !!existing.identity && !!token && !!options.oauth?.isOAuthToken(token) && (await (async () => {
|
|
88
|
+
const prev = existing.hub.client;
|
|
89
|
+
prev.setKey(token);
|
|
90
|
+
const id = await options.oauth.identity(prev).catch(() => null);
|
|
91
|
+
return id === existing.identity;
|
|
92
|
+
})());
|
|
93
|
+
if (!same)
|
|
94
|
+
return rpcError(reply, 401, 'Unauthorized: this session was opened with another key.', challenge(path));
|
|
95
|
+
existing.keyHash = hash;
|
|
96
|
+
}
|
|
97
|
+
if (existing.route !== route.path || existing.params !== paramsKey)
|
|
98
|
+
return rpcError(reply, 400, 'This session belongs to another MCP endpoint.');
|
|
99
|
+
existing.lastSeen = Date.now();
|
|
100
|
+
}
|
|
101
|
+
if (req.method === 'POST') {
|
|
102
|
+
const body = req.body;
|
|
103
|
+
if (existing) {
|
|
104
|
+
reply.hijack();
|
|
105
|
+
return existing.transport.handleRequest(req.raw, reply.raw, body);
|
|
106
|
+
}
|
|
107
|
+
if (sid || !(0, types_js_1.isInitializeRequest)(body))
|
|
108
|
+
return rpcError(reply, 400, 'No valid session: start with an initialize request.');
|
|
109
|
+
let transport;
|
|
110
|
+
const opened = await open(route, req, reply, token, params, async (hub, identity) => {
|
|
111
|
+
transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
|
|
112
|
+
sessionIdGenerator: () => node_crypto_1.default.randomUUID(),
|
|
113
|
+
onsessioninitialized: (id) => {
|
|
114
|
+
sessions.set(id, { transport, keyHash: hash, route: route.path, params: paramsKey, lastSeen: Date.now(), hub, ...(identity ? { identity } : {}) });
|
|
115
|
+
},
|
|
116
|
+
});
|
|
117
|
+
transport.onclose = () => { if (transport.sessionId)
|
|
118
|
+
sessions.delete(transport.sessionId); };
|
|
119
|
+
return transport;
|
|
120
|
+
});
|
|
121
|
+
if (!opened || !('transport' in opened))
|
|
122
|
+
return opened;
|
|
123
|
+
reply.hijack();
|
|
124
|
+
await transport.handleRequest(req.raw, reply.raw, body);
|
|
125
|
+
return;
|
|
126
|
+
}
|
|
127
|
+
if (req.method === 'GET' || req.method === 'DELETE') {
|
|
128
|
+
if (!existing)
|
|
129
|
+
return rpcError(reply, 400, 'Unknown or missing mcp-session-id.');
|
|
130
|
+
reply.hijack();
|
|
131
|
+
return existing.transport.handleRequest(req.raw, reply.raw);
|
|
132
|
+
}
|
|
133
|
+
return rpcError(reply, 405, 'Method not allowed', { Allow: 'GET, POST, DELETE' });
|
|
134
|
+
};
|
|
135
|
+
app.route({ method: ['GET', 'POST', 'DELETE'], url: route.path, handler });
|
|
136
|
+
}
|
|
137
|
+
if (http.legacySse) {
|
|
138
|
+
const sse = http.legacySse;
|
|
139
|
+
const route = routes.find((r) => r.path === (sse.route ?? '/mcp')) ?? routes[0];
|
|
140
|
+
app.get(sse.ssePath, async (req, reply) => {
|
|
141
|
+
const token = (0, core_1.bearerOf)(req.headers.authorization);
|
|
142
|
+
if (token && !accept(token))
|
|
143
|
+
return rpcError(reply, 401, 'Unauthorized.', challenge(sse.ssePath));
|
|
144
|
+
if (!token && !route.anonymous)
|
|
145
|
+
return rpcError(reply, 401, 'Unauthorized: send "Authorization: Bearer <key>".', challenge(sse.ssePath));
|
|
146
|
+
let transport;
|
|
147
|
+
const opened = await open(route, req, reply, token, {}, async () => {
|
|
148
|
+
reply.hijack();
|
|
149
|
+
transport = new sse_js_1.SSEServerTransport(sse.messagesPath, reply.raw);
|
|
150
|
+
return transport;
|
|
151
|
+
});
|
|
152
|
+
if (!opened || !('transport' in opened))
|
|
153
|
+
return;
|
|
154
|
+
sessions.set(transport.sessionId, { transport, keyHash: token ? (0, hub_js_1.keyHash)(token) : null, route: route.path, params: '{}', lastSeen: Date.now(), hub: opened.hub });
|
|
155
|
+
transport.onclose = () => sessions.delete(transport.sessionId);
|
|
156
|
+
});
|
|
157
|
+
app.post(sse.messagesPath, async (req, reply) => {
|
|
158
|
+
const sid = req.query.sessionId;
|
|
159
|
+
const s = sid ? sessions.get(sid) : undefined;
|
|
160
|
+
if (!s || !(s.transport instanceof sse_js_1.SSEServerTransport))
|
|
161
|
+
return rpcError(reply, 404, 'Unknown session.');
|
|
162
|
+
const token = (0, core_1.bearerOf)(req.headers.authorization);
|
|
163
|
+
if ((token ? (0, hub_js_1.keyHash)(token) : null) !== s.keyHash)
|
|
164
|
+
return rpcError(reply, 401, 'Unauthorized: this session was opened with another key.');
|
|
165
|
+
s.lastSeen = Date.now();
|
|
166
|
+
reply.hijack();
|
|
167
|
+
await s.transport.handlePostMessage(req.raw, reply.raw, req.body);
|
|
168
|
+
});
|
|
169
|
+
}
|
|
170
|
+
const sweeper = setInterval(() => {
|
|
171
|
+
const now = Date.now();
|
|
172
|
+
for (const s of sessions.values())
|
|
173
|
+
if (now - s.lastSeen > idleMs)
|
|
174
|
+
void s.transport.close();
|
|
175
|
+
}, Math.min(idleMs, 60_000));
|
|
176
|
+
sweeper.unref();
|
|
177
|
+
await core_1.httpServer.start(app, { port: http.port, host: http.host });
|
|
178
|
+
return {
|
|
179
|
+
app,
|
|
180
|
+
pool,
|
|
181
|
+
sessions: () => sessions.size,
|
|
182
|
+
close: async () => {
|
|
183
|
+
clearInterval(sweeper);
|
|
184
|
+
for (const s of sessions.values())
|
|
185
|
+
await s.transport.close().catch(() => undefined);
|
|
186
|
+
sessions.clear();
|
|
187
|
+
pool.stop();
|
|
188
|
+
await app.close();
|
|
189
|
+
},
|
|
190
|
+
};
|
|
191
|
+
}
|
|
192
|
+
//# sourceMappingURL=http.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
2
|
+
import { Catalog } from './catalog.js';
|
|
3
|
+
import { ApiClient } from './client.js';
|
|
4
|
+
import type { McpRoute, McpServiceOptions } from './options.js';
|
|
5
|
+
import { ResultStore } from './output.js';
|
|
6
|
+
/** sha256 of a key: cache key of its catalog (the secret itself is never a map key). */
|
|
7
|
+
export declare function keyHash(apiKey: string): string;
|
|
8
|
+
/**
|
|
9
|
+
* State of one key (or of anonymous access): API client, catalog, result cache. Every MCP session of the key gets its own
|
|
10
|
+
* `Server`; catalog changes notify all of them (tools/list_changed).
|
|
11
|
+
*/
|
|
12
|
+
export declare class KeyHub {
|
|
13
|
+
readonly options: McpServiceOptions;
|
|
14
|
+
readonly client: ApiClient;
|
|
15
|
+
readonly catalog: Catalog | null;
|
|
16
|
+
readonly store: ResultStore;
|
|
17
|
+
private readonly servers;
|
|
18
|
+
private timer;
|
|
19
|
+
lastUsed: number;
|
|
20
|
+
constructor(options: McpServiceOptions, apiKey: string | null);
|
|
21
|
+
get sessions(): number;
|
|
22
|
+
private get refreshMs();
|
|
23
|
+
/** Loads the catalog when never loaded or stale; 401/403 propagate, other errors keep the last catalog. */
|
|
24
|
+
ensureFresh(): Promise<void>;
|
|
25
|
+
private notifyChanged;
|
|
26
|
+
/** Re-reads the catalog; notifies sessions on change. Errors keep the last catalog. */
|
|
27
|
+
refresh(): Promise<boolean>;
|
|
28
|
+
startTimer(): void;
|
|
29
|
+
stop(): void;
|
|
30
|
+
/** An MCP server for one session of `route` with its params. */
|
|
31
|
+
createServer(route: McpRoute, params: Record<string, string>, lang: string | null, closeTimerWhenIdle: boolean, keyId: string | null): Server;
|
|
32
|
+
}
|
|
33
|
+
/** HTTP mode: one KeyHub per key hash (+ one anonymous); idle hubs are evicted. */
|
|
34
|
+
export declare class HubPool {
|
|
35
|
+
readonly options: McpServiceOptions;
|
|
36
|
+
private readonly hubs;
|
|
37
|
+
constructor(options: McpServiceOptions);
|
|
38
|
+
get size(): number;
|
|
39
|
+
acquire(apiKey: string | null): Promise<KeyHub>;
|
|
40
|
+
private sweep;
|
|
41
|
+
stop(): void;
|
|
42
|
+
}
|