mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-22 03:02:20 +00:00
183 lines
5.7 KiB
JavaScript
183 lines
5.7 KiB
JavaScript
import assert from 'node:assert/strict';
|
|
import test from 'node:test';
|
|
import { composeCatalog, defineTool, ToolError } from '../catalog.js';
|
|
import {
|
|
createMcpHttpHandler,
|
|
createMcpServer,
|
|
MCP_PROTOCOL_VERSIONS,
|
|
toMcpTools,
|
|
} from './index.js';
|
|
|
|
const tool = (name, run) =>
|
|
defineTool({
|
|
name,
|
|
title: 'Count',
|
|
description: 'Counts things.',
|
|
inputSchema: {
|
|
type: 'object',
|
|
properties: { n: { type: 'integer' } },
|
|
additionalProperties: false,
|
|
},
|
|
run,
|
|
});
|
|
const catalog = composeCatalog({
|
|
tools: [
|
|
tool('count', async ({ n = 1 }) => ({
|
|
summary: `${n} things.`,
|
|
data: { n },
|
|
})),
|
|
tool('busy', async () => {
|
|
throw new ToolError('retry_later', 'Upstream is busy', {
|
|
retryAfterSeconds: 10,
|
|
});
|
|
}),
|
|
tool('crash', async () => {
|
|
throw new Error('database password is hunter2');
|
|
}),
|
|
],
|
|
});
|
|
const server = createMcpServer({
|
|
catalog,
|
|
name: 'test',
|
|
version: '1.0.0',
|
|
instructions: 'Be brief.',
|
|
});
|
|
const request = (method, params, id = 1) =>
|
|
server.handle({ jsonrpc: '2.0', id, method, params });
|
|
|
|
test('initialize negotiates a supported protocol version', async () => {
|
|
const known = await request('initialize', { protocolVersion: '2025-06-18' });
|
|
assert.deepEqual(known.result, {
|
|
protocolVersion: '2025-06-18',
|
|
capabilities: { tools: { listChanged: false } },
|
|
serverInfo: { name: 'test', version: '1.0.0' },
|
|
instructions: 'Be brief.',
|
|
});
|
|
const unknown = await request('initialize', {
|
|
protocolVersion: '1999-01-01',
|
|
});
|
|
assert.equal(unknown.result.protocolVersion, MCP_PROTOCOL_VERSIONS[0]);
|
|
assert.deepEqual((await request('ping')).result, {});
|
|
});
|
|
|
|
test('notifications and client responses get no reply', async () => {
|
|
assert.equal(
|
|
await server.handle({
|
|
jsonrpc: '2.0',
|
|
method: 'notifications/initialized',
|
|
}),
|
|
null,
|
|
);
|
|
assert.equal(
|
|
await server.handle({ jsonrpc: '2.0', id: 9, result: {} }),
|
|
null,
|
|
);
|
|
});
|
|
|
|
test('invalid messages and unknown methods are JSON-RPC errors', async () => {
|
|
assert.equal(
|
|
(await server.handle({ id: 1, method: 'ping' })).error.code,
|
|
-32600,
|
|
);
|
|
assert.equal(
|
|
(await server.handle([{ jsonrpc: '2.0', id: 1, method: 'ping' }])).error
|
|
.code,
|
|
-32600,
|
|
);
|
|
assert.equal(
|
|
(await server.handle({ jsonrpc: '2.0', id: 1 })).error.code,
|
|
-32600,
|
|
);
|
|
assert.equal((await request('tools/remove')).error.code, -32601);
|
|
assert.equal((await request('toString')).error.code, -32601);
|
|
assert.equal((await request('tools/list', [])).error.code, -32602);
|
|
assert.equal(
|
|
(await request('tools/call', { name: 'missing' })).error.code,
|
|
-32602,
|
|
);
|
|
});
|
|
|
|
test('tools are listed with titles, schemas and annotations, with surface overrides', async () => {
|
|
const { tools } = (await request('tools/list')).result;
|
|
assert.deepEqual(tools[0], {
|
|
name: 'count',
|
|
title: 'Count',
|
|
description: 'Counts things.',
|
|
inputSchema: {
|
|
type: 'object',
|
|
properties: { n: { type: 'integer' } },
|
|
additionalProperties: false,
|
|
},
|
|
annotations: { title: 'Count', readOnlyHint: true },
|
|
});
|
|
const [custom] = toMcpTools(catalog, {
|
|
descriptions: { count: { description: 'Counts for this surface.' } },
|
|
decorate: (definition, source) => ({
|
|
_meta: { kind: source.kind, seen: definition.name },
|
|
}),
|
|
});
|
|
assert.equal(custom.description, 'Counts for this surface.');
|
|
assert.deepEqual(custom._meta, { kind: 'query', seen: 'count' });
|
|
});
|
|
|
|
test('tool results carry text and structured content; failures stay generic', async () => {
|
|
assert.deepEqual(
|
|
(await request('tools/call', { name: 'count', arguments: { n: 3 } }))
|
|
.result,
|
|
{
|
|
content: [
|
|
{ type: 'text', text: '3 things.' },
|
|
{ type: 'text', text: '{"n":3}' },
|
|
],
|
|
structuredContent: { n: 3 },
|
|
isError: false,
|
|
},
|
|
);
|
|
assert.deepEqual((await request('tools/call', { name: 'busy' })).result, {
|
|
content: [{ type: 'text', text: 'Upstream is busy' }],
|
|
structuredContent: { error: 'retry_later', retry_after_seconds: 10 },
|
|
isError: true,
|
|
});
|
|
const invalid = (
|
|
await request('tools/call', { name: 'count', arguments: { n: 'x' } })
|
|
).result;
|
|
assert.equal(invalid.isError, true);
|
|
assert.equal(invalid.structuredContent.error, 'invalid_arguments');
|
|
const crash = (await request('tools/call', { name: 'crash' })).result;
|
|
assert.equal(crash.isError, true);
|
|
assert.equal(JSON.stringify(crash).includes('hunter2'), false);
|
|
});
|
|
|
|
test('the HTTP transport accepts one JSON message per POST', async () => {
|
|
const handle = createMcpHttpHandler(server);
|
|
const post = (body, headers = {}) =>
|
|
handle(
|
|
new Request('http://localhost/mcp', {
|
|
method: 'POST',
|
|
headers: { 'Content-Type': 'application/json', ...headers },
|
|
body: typeof body === 'string' ? body : JSON.stringify(body),
|
|
}),
|
|
);
|
|
const ok = await post({ jsonrpc: '2.0', id: 1, method: 'ping' });
|
|
assert.equal(ok.status, 200);
|
|
assert.equal(ok.headers.get('content-type'), 'application/json');
|
|
assert.deepEqual(await ok.json(), { jsonrpc: '2.0', id: 1, result: {} });
|
|
assert.equal(
|
|
(await post({ jsonrpc: '2.0', method: 'notifications/initialized' }))
|
|
.status,
|
|
202,
|
|
);
|
|
const parse = await post('{');
|
|
assert.equal(parse.status, 400);
|
|
assert.equal((await parse.json()).error.code, -32700);
|
|
assert.equal(
|
|
(await post({}, { 'MCP-Protocol-Version': '1999-01-01' })).status,
|
|
400,
|
|
);
|
|
assert.equal((await post({}, { 'Content-Type': 'text/plain' })).status, 415);
|
|
assert.equal((await post('x'.repeat(1024 * 1024 + 1))).status, 413);
|
|
const get = await handle(new Request('http://localhost/mcp'));
|
|
assert.equal(get.status, 405);
|
|
assert.equal(get.headers.get('allow'), 'POST');
|
|
});
|