@inspectr/mcplab-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# MCPLab MCP Server
+
+MCP server that exposes MCPLab authoring and execution helpers for other LLM clients.
+
+## Focus
+
+- Generate MCPLab YAML entries for `servers`, `agents`, and especially `scenarios`
+- Validate configs via `@inspectr/mcplab-core` (`loadConfig`, `selectScenarios`)
+- Run evaluations and inspect run artifacts
+- Provide scenario-authoring prompts for MCP-capable clients
+
+## Run (Streamable HTTP)
+
+```bash
+npm run build -w @inspectr/mcplab-mcp-server
+node packages/mcp-server/dist/index.js
+```
+
+Defaults:
+
+- Host: `127.0.0.1`
+- Port: `3011`
+- MCP endpoint: `/mcp`
+
+Override with `MCP_HOST`, `MCP_PORT`, and `MCP_PATH`.
+
+## Minimal Manual-Test MCP Servers (Dev Only)
+
+These tiny servers are useful for manual testing in MCP Lab (connectivity, auth, OAuth Debugger).
+They live outside the published package code in:
+
+- `/Users/tim.haselaars/Sites/mcp-evaluation/dev/mcp-test-servers`
+
+### 1) Public (no auth)
+
+```bash
+npm run mcp:test:public
+```
+
+Defaults:
+- Base URL: `http://127.0.0.1:3111`
+- MCP endpoint: `/mcp`
+
+### 2) Bearer-protected
+
+```bash
+MCP_TEST_BEARER_TOKEN=demo-bearer-token npm run mcp:test:bearer
+```
+
+Defaults:
+- Base URL: `http://127.0.0.1:3112`
+- MCP endpoint: `/mcp`
+- Protected probe endpoint: `/probe`
+
+### 3) OAuth mock (for OAuth Debugger)
+
+```bash
+npm run mcp:test:oauth-mock
+```
+
+Defaults:
+- Base URL: `http://127.0.0.1:3113`
+- MCP endpoint: `/mcp` (bearer-protected after token exchange)
+- OAuth endpoints:
+  - `/.well-known/oauth-protected-resource`
+  - `/.well-known/oauth-authorization-server`
+  - `/authorize`
+  - `/token`
+  - `/register` (DCR)
+  - `/client-metadata.json` (CIMD)
+  - `/probe` (protected resource probe)
+
+Default pre-registered client:
+- `client_id`: `mcplab-debugger`
+- `client_secret`: `mcplab-debugger-secret`
+- `redirect_url`: `http://localhost:6274/oauth/`
+- `scope`: `openid profile mcp`
+
+## Useful Tools
+
+- `mcplab_generate_scenario_entry`
+- `mcplab_validate_config`
+- `mcplab_list_library`
+- `mcplab_get_library_item`
+- `mcplab_run_eval`
+- `mcplab_read_run_artifact`

package/dist/http-handler.d.ts

@@ -0,0 +1,3 @@
+export { handleMcplabMcpHttpRequest } from './runtime.js';
+export type { SessionRuntime } from './runtime.js';
+//# sourceMappingURL=http-handler.d.ts.map

package/dist/http-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-handler.d.ts","sourceRoot":"","sources":["../src/http-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/http-handler.js

@@ -0,0 +1,2 @@
+export { handleMcplabMcpHttpRequest } from './runtime.js';
+//# sourceMappingURL=http-handler.js.map

package/dist/http-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-handler.js","sourceRoot":"","sources":["../src/http-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { defaultMcplabMcpServerOptionsFromEnv, startMcplabMcpServer } from './runtime.js';
+async function main() {
+    const runtime = await startMcplabMcpServer(defaultMcplabMcpServerOptionsFromEnv());
+    const shutdown = async () => {
+        await runtime.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', () => {
+        void shutdown();
+    });
+    process.on('SIGTERM', () => {
+        void shutdown();
+    });
+}
+main().catch((error) => {
+    console.error('[mcplab-mcp-server] fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oCAAoC,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE1F,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,oCAAoC,EAAE,CAAC,CAAC;IAEnF,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,KAAK,QAAQ,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,KAAK,QAAQ,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,2 @@
+export { registerPrompts } from './runtime.js';
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/prompts.js

@@ -0,0 +1,2 @@
+export { registerPrompts } from './runtime.js';
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,35 @@
+import { type IncomingMessage, type ServerResponse } from 'node:http';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+export type SessionRuntime = {
+  transport: StreamableHTTPServerTransport;
+  server: McpServer;
+};
+export interface McplabMcpServerOptions {
+  host: string;
+  port: number;
+  path: string;
+  logger?: Pick<Console, 'log' | 'error'>;
+}
+export interface McplabMcpServerRuntime {
+  host: string;
+  port: number;
+  path: string;
+  close(): Promise<void>;
+}
+export declare function startMcplabMcpServer(
+  options: McplabMcpServerOptions
+): Promise<McplabMcpServerRuntime>;
+export declare function defaultMcplabMcpServerOptionsFromEnv(): McplabMcpServerOptions;
+export declare function createConfiguredServer(): McpServer;
+export declare function registerTools(server: McpServer): void;
+export declare function registerPrompts(server: McpServer): void;
+export declare function handleMcplabMcpHttpRequest(
+  req: IncomingMessage,
+  res: ServerResponse,
+  sessions: Map<string, SessionRuntime>,
+  options?: {
+    path?: string;
+  }
+): Promise<void>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAUA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAsCnG,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAoDjC;AAED,wBAAgB,oCAAoC,IAAI,sBAAsB,CAM7E;AAED,wBAAgB,sBAAsB,IAAI,SAAS,CAQlD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6iCrD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8EvD;AA04BD,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACrC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAEf"}