cas-parser-node-mcp 1.2.0 → 1.3.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.
Files changed (93) hide show
  1. package/README.md +13 -0
  2. package/code-tool-paths.cjs +6 -0
  3. package/code-tool-paths.cjs.map +1 -0
  4. package/code-tool-paths.d.cts +2 -0
  5. package/code-tool-paths.d.cts.map +1 -0
  6. package/code-tool-types.d.mts +14 -0
  7. package/code-tool-types.d.mts.map +1 -0
  8. package/code-tool-types.d.ts +14 -0
  9. package/code-tool-types.d.ts.map +1 -0
  10. package/code-tool-types.js +4 -0
  11. package/code-tool-types.js.map +1 -0
  12. package/code-tool-types.mjs +3 -0
  13. package/code-tool-types.mjs.map +1 -0
  14. package/code-tool-worker.d.mts +5 -0
  15. package/code-tool-worker.d.mts.map +1 -0
  16. package/code-tool-worker.d.ts +5 -0
  17. package/code-tool-worker.d.ts.map +1 -0
  18. package/code-tool-worker.js +45 -0
  19. package/code-tool-worker.js.map +1 -0
  20. package/code-tool-worker.mjs +40 -0
  21. package/code-tool-worker.mjs.map +1 -0
  22. package/code-tool.d.mts +12 -0
  23. package/code-tool.d.mts.map +1 -0
  24. package/code-tool.d.ts +12 -0
  25. package/code-tool.d.ts.map +1 -0
  26. package/code-tool.js +123 -0
  27. package/code-tool.js.map +1 -0
  28. package/code-tool.mjs +120 -0
  29. package/code-tool.mjs.map +1 -0
  30. package/compat.d.mts +4 -2
  31. package/compat.d.mts.map +1 -1
  32. package/compat.d.ts +4 -2
  33. package/compat.d.ts.map +1 -1
  34. package/compat.js +3 -1
  35. package/compat.js.map +1 -1
  36. package/compat.mjs +2 -0
  37. package/compat.mjs.map +1 -1
  38. package/headers.d.mts +1 -1
  39. package/headers.d.mts.map +1 -1
  40. package/headers.d.ts +1 -1
  41. package/headers.d.ts.map +1 -1
  42. package/headers.js +1 -1
  43. package/headers.js.map +1 -1
  44. package/headers.mjs +1 -1
  45. package/headers.mjs.map +1 -1
  46. package/http.d.mts +1 -2
  47. package/http.d.mts.map +1 -1
  48. package/http.d.ts +1 -2
  49. package/http.d.ts.map +1 -1
  50. package/http.js +19 -2
  51. package/http.js.map +1 -1
  52. package/http.mjs +19 -2
  53. package/http.mjs.map +1 -1
  54. package/index.js +3 -3
  55. package/index.js.map +1 -1
  56. package/index.mjs +4 -4
  57. package/index.mjs.map +1 -1
  58. package/options.d.mts +8 -6
  59. package/options.d.mts.map +1 -1
  60. package/options.d.ts +8 -6
  61. package/options.d.ts.map +1 -1
  62. package/options.js +118 -15
  63. package/options.js.map +1 -1
  64. package/options.mjs +117 -15
  65. package/options.mjs.map +1 -1
  66. package/package.json +47 -4
  67. package/server.d.mts +3 -16
  68. package/server.d.mts.map +1 -1
  69. package/server.d.ts +3 -16
  70. package/server.d.ts.map +1 -1
  71. package/server.js +45 -21
  72. package/server.js.map +1 -1
  73. package/server.mjs +44 -20
  74. package/server.mjs.map +1 -1
  75. package/src/code-tool-paths.cts +3 -0
  76. package/src/code-tool-types.ts +14 -0
  77. package/src/code-tool-worker.ts +46 -0
  78. package/src/code-tool.ts +144 -0
  79. package/src/compat.ts +4 -2
  80. package/src/headers.ts +2 -3
  81. package/src/http.ts +24 -8
  82. package/src/index.ts +4 -4
  83. package/src/options.ts +136 -21
  84. package/src/server.ts +54 -34
  85. package/src/stdio.ts +3 -4
  86. package/stdio.d.mts +1 -2
  87. package/stdio.d.mts.map +1 -1
  88. package/stdio.d.ts +1 -2
  89. package/stdio.d.ts.map +1 -1
  90. package/stdio.js +2 -2
  91. package/stdio.js.map +1 -1
  92. package/stdio.mjs +3 -3
  93. package/stdio.mjs.map +1 -1
package/server.js CHANGED
@@ -4,9 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
4
4
  return (mod && mod.__esModule) ? mod : { "default": mod };
5
5
  };
6
6
  Object.defineProperty(exports, "__esModule", { value: true });
7
- exports.readEnvOrError = exports.readEnv = exports.server = exports.newMcpServer = exports.endpoints = void 0;
7
+ exports.readEnvOrError = exports.readEnv = exports.server = exports.newMcpServer = exports.endpoints = exports.ClientType = void 0;
8
8
  exports.initMcpServer = initMcpServer;
9
- exports.init = init;
10
9
  exports.selectTools = selectTools;
11
10
  exports.executeHandler = executeHandler;
12
11
  const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
@@ -15,11 +14,14 @@ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
15
14
  const cas_parser_node_1 = __importDefault(require("cas-parser-node"));
16
15
  const compat_1 = require("./compat.js");
17
16
  const dynamic_tools_1 = require("./dynamic-tools.js");
17
+ const code_tool_1 = require("./code-tool.js");
18
+ var compat_2 = require("./compat.js");
19
+ Object.defineProperty(exports, "ClientType", { enumerable: true, get: function () { return compat_2.ClientType; } });
18
20
  var tools_2 = require("./tools.js");
19
21
  Object.defineProperty(exports, "endpoints", { enumerable: true, get: function () { return tools_2.endpoints; } });
20
22
  const newMcpServer = () => new mcp_js_1.McpServer({
21
23
  name: 'cas_parser_node_api',
22
- version: '1.2.0',
24
+ version: '1.3.0',
23
25
  }, { capabilities: { tools: {}, logging: {} } });
24
26
  exports.newMcpServer = newMcpServer;
25
27
  // Create server instance
@@ -29,18 +31,24 @@ exports.server = (0, exports.newMcpServer)();
29
31
  * If not provided, the default client, tools and handlers will be used.
30
32
  */
31
33
  function initMcpServer(params) {
32
- const transformedEndpoints = selectTools(tools_1.endpoints, params.mcpOptions);
33
- const client = new cas_parser_node_1.default(params.clientOptions);
34
- const capabilities = {
35
- ...compat_1.defaultClientCapabilities,
36
- ...(params.mcpOptions.client ? compat_1.knownClients[params.mcpOptions.client] : params.mcpOptions.capabilities),
37
- };
38
- init({ server: params.server, client, endpoints: transformedEndpoints, capabilities });
39
- }
40
- function init(params) {
41
34
  const server = params.server instanceof mcp_js_1.McpServer ? params.server.server : params.server;
42
- const providedEndpoints = params.endpoints || tools_1.endpoints;
43
- const endpointMap = Object.fromEntries(providedEndpoints.map((endpoint) => [endpoint.tool.name, endpoint]));
35
+ const mcpOptions = params.mcpOptions ?? {};
36
+ let providedEndpoints = null;
37
+ let endpointMap = null;
38
+ const initTools = (implementation) => {
39
+ if (implementation && (!mcpOptions.client || mcpOptions.client === 'infer')) {
40
+ mcpOptions.client =
41
+ implementation.name.toLowerCase().includes('claude') ? 'claude'
42
+ : implementation.name.toLowerCase().includes('cursor') ? 'cursor'
43
+ : undefined;
44
+ mcpOptions.capabilities = {
45
+ ...(mcpOptions.client && compat_1.knownClients[mcpOptions.client]),
46
+ ...mcpOptions.capabilities,
47
+ };
48
+ }
49
+ providedEndpoints = selectTools(tools_1.endpoints, mcpOptions);
50
+ endpointMap = Object.fromEntries(providedEndpoints.map((endpoint) => [endpoint.tool.name, endpoint]));
51
+ };
44
52
  const logAtLevel = (level) => (message, ...rest) => {
45
53
  void server.sendLoggingMessage({
46
54
  level,
@@ -53,44 +61,60 @@ function init(params) {
53
61
  warn: logAtLevel('warning'),
54
62
  error: logAtLevel('error'),
55
63
  };
56
- const client = params.client || new cas_parser_node_1.default({ defaultHeaders: { 'X-Stainless-MCP': 'true' }, logger: logger });
64
+ const client = new cas_parser_node_1.default({
65
+ logger,
66
+ ...params.clientOptions,
67
+ defaultHeaders: {
68
+ ...params.clientOptions?.defaultHeaders,
69
+ 'X-Stainless-MCP': 'true',
70
+ },
71
+ });
57
72
  server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
73
+ if (providedEndpoints === null) {
74
+ initTools(server.getClientVersion());
75
+ }
58
76
  return {
59
77
  tools: providedEndpoints.map((endpoint) => endpoint.tool),
60
78
  };
61
79
  });
62
80
  server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
81
+ if (endpointMap === null) {
82
+ initTools(server.getClientVersion());
83
+ }
63
84
  const { name, arguments: args } = request.params;
64
85
  const endpoint = endpointMap[name];
65
86
  if (!endpoint) {
66
87
  throw new Error(`Unknown tool: ${name}`);
67
88
  }
68
- return executeHandler(endpoint.tool, endpoint.handler, client, args, params.capabilities);
89
+ return executeHandler(endpoint.tool, endpoint.handler, client, args, mcpOptions.capabilities);
69
90
  });
70
91
  }
71
92
  /**
72
93
  * Selects the tools to include in the MCP Server based on the provided options.
73
94
  */
74
95
  function selectTools(endpoints, options) {
75
- const filteredEndpoints = (0, tools_1.query)(options.filters, endpoints);
96
+ const filteredEndpoints = (0, tools_1.query)(options?.filters ?? [], endpoints);
76
97
  let includedTools = filteredEndpoints;
77
98
  if (includedTools.length > 0) {
78
- if (options.includeDynamicTools) {
99
+ if (options?.includeDynamicTools) {
79
100
  includedTools = (0, dynamic_tools_1.dynamicTools)(includedTools);
80
101
  }
81
102
  }
82
103
  else {
83
- if (options.includeAllTools) {
104
+ if (options?.includeAllTools) {
84
105
  includedTools = endpoints;
85
106
  }
86
- else if (options.includeDynamicTools) {
107
+ else if (options?.includeDynamicTools) {
87
108
  includedTools = (0, dynamic_tools_1.dynamicTools)(endpoints);
88
109
  }
110
+ else if (options?.includeCodeTools) {
111
+ includedTools = [(0, code_tool_1.codeTool)()];
112
+ }
89
113
  else {
90
114
  includedTools = endpoints;
91
115
  }
92
116
  }
93
- const capabilities = { ...compat_1.defaultClientCapabilities, ...options.capabilities };
117
+ const capabilities = { ...compat_1.defaultClientCapabilities, ...options?.capabilities };
94
118
  return (0, compat_1.applyCompatibilityTransformations)(includedTools, capabilities);
95
119
  }
96
120
  /**
package/server.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"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"}
package/server.mjs CHANGED
@@ -1,14 +1,16 @@
1
1
  // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
2
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
3
  import { endpoints, query } from "./tools.mjs";
4
- import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
4
+ import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
5
5
  import CasParser from 'cas-parser-node';
6
6
  import { applyCompatibilityTransformations, defaultClientCapabilities, knownClients, parseEmbeddedJSON, } from "./compat.mjs";
7
7
  import { dynamicTools } from "./dynamic-tools.mjs";
8
+ import { codeTool } from "./code-tool.mjs";
9
+ export { ClientType } from "./compat.mjs";
8
10
  export { endpoints } from "./tools.mjs";
9
11
  export const newMcpServer = () => new McpServer({
10
12
  name: 'cas_parser_node_api',
11
- version: '1.2.0',
13
+ version: '1.3.0',
12
14
  }, { capabilities: { tools: {}, logging: {} } });
13
15
  // Create server instance
14
16
  export const server = newMcpServer();
@@ -17,18 +19,24 @@ export const server = newMcpServer();
17
19
  * If not provided, the default client, tools and handlers will be used.
18
20
  */
19
21
  export function initMcpServer(params) {
20
- const transformedEndpoints = selectTools(endpoints, params.mcpOptions);
21
- const client = new CasParser(params.clientOptions);
22
- const capabilities = {
23
- ...defaultClientCapabilities,
24
- ...(params.mcpOptions.client ? knownClients[params.mcpOptions.client] : params.mcpOptions.capabilities),
25
- };
26
- init({ server: params.server, client, endpoints: transformedEndpoints, capabilities });
27
- }
28
- export function init(params) {
29
22
  const server = params.server instanceof McpServer ? params.server.server : params.server;
30
- const providedEndpoints = params.endpoints || endpoints;
31
- const endpointMap = Object.fromEntries(providedEndpoints.map((endpoint) => [endpoint.tool.name, endpoint]));
23
+ const mcpOptions = params.mcpOptions ?? {};
24
+ let providedEndpoints = null;
25
+ let endpointMap = null;
26
+ const initTools = (implementation) => {
27
+ if (implementation && (!mcpOptions.client || mcpOptions.client === 'infer')) {
28
+ mcpOptions.client =
29
+ implementation.name.toLowerCase().includes('claude') ? 'claude'
30
+ : implementation.name.toLowerCase().includes('cursor') ? 'cursor'
31
+ : undefined;
32
+ mcpOptions.capabilities = {
33
+ ...(mcpOptions.client && knownClients[mcpOptions.client]),
34
+ ...mcpOptions.capabilities,
35
+ };
36
+ }
37
+ providedEndpoints = selectTools(endpoints, mcpOptions);
38
+ endpointMap = Object.fromEntries(providedEndpoints.map((endpoint) => [endpoint.tool.name, endpoint]));
39
+ };
32
40
  const logAtLevel = (level) => (message, ...rest) => {
33
41
  void server.sendLoggingMessage({
34
42
  level,
@@ -41,44 +49,60 @@ export function init(params) {
41
49
  warn: logAtLevel('warning'),
42
50
  error: logAtLevel('error'),
43
51
  };
44
- const client = params.client || new CasParser({ defaultHeaders: { 'X-Stainless-MCP': 'true' }, logger: logger });
52
+ const client = new CasParser({
53
+ logger,
54
+ ...params.clientOptions,
55
+ defaultHeaders: {
56
+ ...params.clientOptions?.defaultHeaders,
57
+ 'X-Stainless-MCP': 'true',
58
+ },
59
+ });
45
60
  server.setRequestHandler(ListToolsRequestSchema, async () => {
61
+ if (providedEndpoints === null) {
62
+ initTools(server.getClientVersion());
63
+ }
46
64
  return {
47
65
  tools: providedEndpoints.map((endpoint) => endpoint.tool),
48
66
  };
49
67
  });
50
68
  server.setRequestHandler(CallToolRequestSchema, async (request) => {
69
+ if (endpointMap === null) {
70
+ initTools(server.getClientVersion());
71
+ }
51
72
  const { name, arguments: args } = request.params;
52
73
  const endpoint = endpointMap[name];
53
74
  if (!endpoint) {
54
75
  throw new Error(`Unknown tool: ${name}`);
55
76
  }
56
- return executeHandler(endpoint.tool, endpoint.handler, client, args, params.capabilities);
77
+ return executeHandler(endpoint.tool, endpoint.handler, client, args, mcpOptions.capabilities);
57
78
  });
58
79
  }
59
80
  /**
60
81
  * Selects the tools to include in the MCP Server based on the provided options.
61
82
  */
62
83
  export function selectTools(endpoints, options) {
63
- const filteredEndpoints = query(options.filters, endpoints);
84
+ const filteredEndpoints = query(options?.filters ?? [], endpoints);
64
85
  let includedTools = filteredEndpoints;
65
86
  if (includedTools.length > 0) {
66
- if (options.includeDynamicTools) {
87
+ if (options?.includeDynamicTools) {
67
88
  includedTools = dynamicTools(includedTools);
68
89
  }
69
90
  }
70
91
  else {
71
- if (options.includeAllTools) {
92
+ if (options?.includeAllTools) {
72
93
  includedTools = endpoints;
73
94
  }
74
- else if (options.includeDynamicTools) {
95
+ else if (options?.includeDynamicTools) {
75
96
  includedTools = dynamicTools(endpoints);
76
97
  }
98
+ else if (options?.includeCodeTools) {
99
+ includedTools = [codeTool()];
100
+ }
77
101
  else {
78
102
  includedTools = endpoints;
79
103
  }
80
104
  }
81
- const capabilities = { ...defaultClientCapabilities, ...options.capabilities };
105
+ const capabilities = { ...defaultClientCapabilities, ...options?.capabilities };
82
106
  return applyCompatibilityTransformations(includedTools, capabilities);
83
107
  }
84
108
  /**
package/server.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"server.mjs","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"server.mjs","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAG/E,EAAE,SAAS,EAAE,MAAM,yCAAyC;OAC5D,EAAY,SAAS,EAAmB,KAAK,EAAE;OAC/C,EACL,qBAAqB,EAErB,sBAAsB,GAEvB,MAAM,oCAAoC;OAEpC,SAAS,MAAM,iBAAiB;OAChC,EACL,iCAAiC,EAEjC,yBAAyB,EACzB,YAAY,EACZ,iBAAiB,GAClB;OACM,EAAE,YAAY,EAAE;OAChB,EAAE,QAAQ,EAAE;OAIZ,EAAE,UAAU,EAAE;OAGd,EAAE,SAAS,EAAE;AAEpB,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAC/B,IAAI,SAAS,CACX;IACE,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,OAAO;CACjB,EACD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAC7C,CAAC;AAEJ,yBAAyB;AACzB,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAI7B;IACC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,YAAY,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;IACzF,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IAE3C,IAAI,iBAAiB,GAAsB,IAAI,CAAC;IAChD,IAAI,WAAW,GAAoC,IAAI,CAAC;IAExD,MAAM,SAAS,GAAG,CAAC,cAA+B,EAAE,EAAE;QACpD,IAAI,cAAc,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,EAAE,CAAC;YAC5E,UAAU,CAAC,MAAM;gBACf,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ;oBAC/D,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ;wBACjE,CAAC,CAAC,SAAS,CAAC;YACd,UAAU,CAAC,YAAY,GAAG;gBACxB,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBACzD,GAAG,UAAU,CAAC,YAAY;aAC3B,CAAC;QACJ,CAAC;QACD,iBAAiB,GAAG,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACvD,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxG,CAAC,CAAC;IAEF,MAAM,UAAU,GACd,CAAC,KAA6C,EAAE,EAAE,CAClD,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QACtC,KAAK,MAAM,CAAC,kBAAkB,CAAC;YAC7B,KAAK;YACL,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;SACxB,CAAC,CAAC;IACL,CAAC,CAAC;IACJ,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;QAC1B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC;QACxB,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC;QAC3B,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC;KAC3B,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,MAAM;QACN,GAAG,MAAM,CAAC,aAAa;QACvB,cAAc,EAAE;YACd,GAAG,MAAM,CAAC,aAAa,EAAE,cAAc;YACvC,iBAAiB,EAAE,MAAM;SAC1B;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;YAC/B,SAAS,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,OAAO;YACL,KAAK,EAAE,iBAAkB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;SAC3D,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,SAAS,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,QAAQ,GAAG,WAAY,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,SAAqB,EAAE,OAAoB;IACrE,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;IAEnE,IAAI,aAAa,GAAG,iBAAiB,CAAC;IAEtC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,IAAI,OAAO,EAAE,mBAAmB,EAAE,CAAC;YACjC,aAAa,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,OAAO,EAAE,eAAe,EAAE,CAAC;YAC7B,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;aAAM,IAAI,OAAO,EAAE,mBAAmB,EAAE,CAAC;YACxC,aAAa,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,OAAO,EAAE,gBAAgB,EAAE,CAAC;YACrC,aAAa,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,EAAE,GAAG,yBAAyB,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,CAAC;IAChF,OAAO,iCAAiC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAU,EACV,OAAwB,EACxB,MAAiB,EACjB,IAAyC,EACzC,oBAAkD;IAElD,MAAM,OAAO,GAAG,EAAE,GAAG,yBAAyB,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC1E,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;QAC/B,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,OAAO,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAsB,EAAE;IACzD,IAAI,OAAQ,UAAkB,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACvD,OAAQ,UAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;IACxD,CAAC;SAAM,IAAI,OAAQ,UAAkB,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC3D,OAAQ,UAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO;AACT,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAW,EAAU,EAAE;IACpD,IAAI,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,aAAa,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}
@@ -0,0 +1,3 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ export const workerPath = require.resolve('./code-tool-worker.mjs');
@@ -0,0 +1,14 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ import { ClientOptions } from 'cas-parser-node';
4
+
5
+ export type WorkerInput = {
6
+ opts: ClientOptions;
7
+ code: string;
8
+ };
9
+ export type WorkerSuccess = {
10
+ result: unknown | null;
11
+ logLines: string[];
12
+ errLines: string[];
13
+ };
14
+ export type WorkerError = { message: string | undefined };
@@ -0,0 +1,46 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ import util from 'node:util';
4
+ import { WorkerInput, WorkerSuccess, WorkerError } from './code-tool-types';
5
+ import { CasParser } from 'cas-parser-node';
6
+
7
+ const fetch = async (req: Request): Promise<Response> => {
8
+ const { opts, code } = (await req.json()) as WorkerInput;
9
+ const client = new CasParser({
10
+ ...opts,
11
+ });
12
+
13
+ const logLines: string[] = [];
14
+ const errLines: string[] = [];
15
+ const console = {
16
+ log: (...args: unknown[]) => {
17
+ logLines.push(util.format(...args));
18
+ },
19
+ error: (...args: unknown[]) => {
20
+ errLines.push(util.format(...args));
21
+ },
22
+ };
23
+ try {
24
+ let run_ = async (client: any) => {};
25
+ eval(`
26
+ ${code}
27
+ run_ = run;
28
+ `);
29
+ const result = await run_(client);
30
+ return Response.json({
31
+ result,
32
+ logLines,
33
+ errLines,
34
+ } satisfies WorkerSuccess);
35
+ } catch (e) {
36
+ const message = e instanceof Error ? e.message : undefined;
37
+ return Response.json(
38
+ {
39
+ message,
40
+ } satisfies WorkerError,
41
+ { status: 400, statusText: 'Code execution error' },
42
+ );
43
+ }
44
+ };
45
+
46
+ export default { fetch };
@@ -0,0 +1,144 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ import { dirname } from 'node:path';
4
+ import { pathToFileURL } from 'node:url';
5
+ import CasParser, { ClientOptions } from 'cas-parser-node';
6
+ import { Endpoint, ContentBlock, Metadata } from './tools/types';
7
+
8
+ import { Tool } from '@modelcontextprotocol/sdk/types.js';
9
+
10
+ import { newDenoHTTPWorker } from '@valtown/deno-http-worker';
11
+ import { WorkerInput, WorkerError, WorkerSuccess } from './code-tool-types';
12
+ import { workerPath } from './code-tool-paths.cjs';
13
+
14
+ /**
15
+ * A tool that runs code against a copy of the SDK.
16
+ *
17
+ * Instead of exposing every endpoint as it's own tool, which uses up too many tokens for LLMs to use at once,
18
+ * we expose a single tool that can be used to search for endpoints by name, resource, operation, or tag, and then
19
+ * a generic endpoint that can be used to invoke any endpoint with the provided arguments.
20
+ *
21
+ * @param endpoints - The endpoints to include in the list.
22
+ */
23
+ export function codeTool(): Endpoint {
24
+ const metadata: Metadata = { resource: 'all', operation: 'write', tags: [] };
25
+ const tool: Tool = {
26
+ name: 'execute',
27
+ description:
28
+ 'Runs Typescript code to interact with the API.\nYou are a skilled programmer writing code to interface with the service.\nDefine an async function named "run" that takes a single parameter of an initialized client, and it will be run.\nDo not initialize a client, but instead use the client that you are given as a parameter.\nYou will be returned anything that your function returns, plus the results of any console.log statements.\nIf any code triggers an error, the tool will return an error response, so you do not need to add error handling unless you want to output something more helpful than the raw error.\nIt is not necessary to add comments to code, unless by adding those comments you believe that you can generate better code.\nThis code will run in a container, and you will not be able to use fetch or otherwise interact with the network calls other than through the client you are given.\nAny variables you define won\'t live between successive uses of this call, so make sure to return or log any data you might need later.',
29
+ inputSchema: { type: 'object', properties: { code: { type: 'string' } } },
30
+ };
31
+
32
+ const handler = async (client: CasParser, args: unknown) => {
33
+ const baseURLHostname = new URL(client.baseURL).hostname;
34
+ const { code } = args as { code: string };
35
+
36
+ const worker = await newDenoHTTPWorker(pathToFileURL(workerPath), {
37
+ runFlags: [
38
+ `--node-modules-dir=manual`,
39
+ `--allow-read=code-tool-worker.mjs,${workerPath.replace(/([\/\\]node_modules)[\/\\].+$/, '$1')}/`,
40
+ `--allow-net=${baseURLHostname}`,
41
+ // Allow environment variables because instantiating the client will try to read from them,
42
+ // even though they are not set.
43
+ '--allow-env',
44
+ ],
45
+ printOutput: true,
46
+ spawnOptions: {
47
+ cwd: dirname(workerPath),
48
+ },
49
+ });
50
+
51
+ try {
52
+ const resp = await new Promise<Response>((resolve, reject) => {
53
+ worker.addEventListener('exit', (exitCode) => {
54
+ reject(new Error(`Worker exited with code ${exitCode}`));
55
+ });
56
+
57
+ const opts: ClientOptions = {
58
+ baseURL: client.baseURL,
59
+ apiKey: client.apiKey,
60
+ defaultHeaders: {
61
+ 'X-Stainless-MCP': 'true',
62
+ },
63
+ };
64
+
65
+ const req = worker.request(
66
+ 'http://localhost',
67
+ {
68
+ headers: {
69
+ 'content-type': 'application/json',
70
+ },
71
+ method: 'POST',
72
+ },
73
+ (resp) => {
74
+ const body: Uint8Array[] = [];
75
+ resp.on('error', (err) => {
76
+ reject(err);
77
+ });
78
+ resp.on('data', (chunk) => {
79
+ body.push(chunk);
80
+ });
81
+ resp.on('end', () => {
82
+ resolve(
83
+ new Response(Buffer.concat(body).toString(), {
84
+ status: resp.statusCode ?? 200,
85
+ headers: resp.headers as any,
86
+ }),
87
+ );
88
+ });
89
+ },
90
+ );
91
+
92
+ const body = JSON.stringify({
93
+ opts,
94
+ code,
95
+ } satisfies WorkerInput);
96
+
97
+ req.write(body, (err) => {
98
+ if (err !== null && err !== undefined) {
99
+ reject(err);
100
+ }
101
+ });
102
+
103
+ req.end();
104
+ });
105
+
106
+ if (resp.status === 200) {
107
+ const { result, logLines, errLines } = (await resp.json()) as WorkerSuccess;
108
+ const returnOutput: ContentBlock | null =
109
+ result === null ? null
110
+ : result === undefined ? null
111
+ : {
112
+ type: 'text',
113
+ text: typeof result === 'string' ? (result as string) : JSON.stringify(result),
114
+ };
115
+ const logOutput: ContentBlock | null =
116
+ logLines.length === 0 ?
117
+ null
118
+ : {
119
+ type: 'text',
120
+ text: logLines.join('\n'),
121
+ };
122
+ const errOutput: ContentBlock | null =
123
+ errLines.length === 0 ?
124
+ null
125
+ : {
126
+ type: 'text',
127
+ text: 'Error output:\n' + errLines.join('\n'),
128
+ };
129
+ return {
130
+ content: [returnOutput, logOutput, errOutput].filter((block) => block !== null),
131
+ };
132
+ } else {
133
+ const { message } = (await resp.json()) as WorkerError;
134
+ throw new Error(message);
135
+ }
136
+ } catch (e) {
137
+ throw e;
138
+ } finally {
139
+ worker.terminate();
140
+ }
141
+ };
142
+
143
+ return { metadata, tool, handler };
144
+ }
package/src/compat.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  import { Tool } from '@modelcontextprotocol/sdk/types.js';
2
+ import { z } from 'zod';
2
3
  import { Endpoint } from './tools';
3
4
 
4
5
  export interface ClientCapabilities {
@@ -19,12 +20,13 @@ export const defaultClientCapabilities: ClientCapabilities = {
19
20
  toolNameLength: undefined,
20
21
  };
21
22
 
22
- export type ClientType = 'openai-agents' | 'claude' | 'claude-code' | 'cursor';
23
+ export const ClientType = z.enum(['openai-agents', 'claude', 'claude-code', 'cursor', 'infer']);
24
+ export type ClientType = z.infer<typeof ClientType>;
23
25
 
24
26
  // Client presets for compatibility
25
27
  // Note that these could change over time as models get better, so this is
26
28
  // a best effort.
27
- export const knownClients: Record<ClientType, ClientCapabilities> = {
29
+ export const knownClients: Record<Exclude<ClientType, 'infer'>, ClientCapabilities> = {
28
30
  'openai-agents': {
29
31
  topLevelUnions: false,
30
32
  validJson: true,
package/src/headers.ts CHANGED
@@ -1,11 +1,10 @@
1
1
  // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
2
 
3
- import { type ClientOptions } from 'cas-parser-node/client';
4
-
5
3
  import { IncomingMessage } from 'node:http';
4
+ import { ClientOptions } from 'cas-parser-node';
6
5
 
7
6
  export const parseAuthHeaders = (req: IncomingMessage): Partial<ClientOptions> => {
8
7
  const apiKey =
9
- req.headers['x-api-key'] instanceof Array ? req.headers['x-api-key'][0] : req.headers['x-api-key'];
8
+ Array.isArray(req.headers['x-api-key']) ? req.headers['x-api-key'][0] : req.headers['x-api-key'];
10
9
  return { apiKey };
11
10
  };
package/src/http.ts CHANGED
@@ -4,13 +4,32 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
4
4
  import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
5
5
 
6
6
  import express from 'express';
7
- import { McpOptions } from './options';
7
+ import { fromError } from 'zod-validation-error/v3';
8
+ import { McpOptions, parseQueryOptions } from './options';
8
9
  import { initMcpServer, newMcpServer } from './server';
9
10
  import { parseAuthHeaders } from './headers';
10
- import { Endpoint } from './tools';
11
11
 
12
- const newServer = (mcpOptions: McpOptions, req: express.Request, res: express.Response): McpServer | null => {
12
+ const newServer = (
13
+ defaultMcpOptions: McpOptions,
14
+ req: express.Request,
15
+ res: express.Response,
16
+ ): McpServer | null => {
13
17
  const server = newMcpServer();
18
+
19
+ let mcpOptions: McpOptions;
20
+ try {
21
+ mcpOptions = parseQueryOptions(defaultMcpOptions, req.query);
22
+ } catch (error) {
23
+ res.status(400).json({
24
+ jsonrpc: '2.0',
25
+ error: {
26
+ code: -32000,
27
+ message: `Invalid request: ${fromError(error)}`,
28
+ },
29
+ });
30
+ return null;
31
+ }
32
+
14
33
  try {
15
34
  const authOptions = parseAuthHeaders(req);
16
35
  initMcpServer({
@@ -71,6 +90,7 @@ const del = async (req: express.Request, res: express.Response) => {
71
90
 
72
91
  export const streamableHTTPApp = (options: McpOptions): express.Express => {
73
92
  const app = express();
93
+ app.set('query parser', 'extended');
74
94
  app.use(express.json());
75
95
 
76
96
  app.get('/', get);
@@ -80,11 +100,7 @@ export const streamableHTTPApp = (options: McpOptions): express.Express => {
80
100
  return app;
81
101
  };
82
102
 
83
- export const launchStreamableHTTPServer = async (
84
- options: McpOptions,
85
- endpoints: Endpoint[],
86
- port: number | string | undefined,
87
- ) => {
103
+ export const launchStreamableHTTPServer = async (options: McpOptions, port: number | string | undefined) => {
88
104
  const app = streamableHTTPApp(options);
89
105
  const server = app.listen(port);
90
106
  const address = server.address();
package/src/index.ts CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  import { selectTools } from './server';
4
4
  import { Endpoint, endpoints } from './tools';
5
- import { McpOptions, parseOptions } from './options';
5
+ import { McpOptions, parseCLIOptions } from './options';
6
6
  import { launchStdioServer } from './stdio';
7
7
  import { launchStreamableHTTPServer } from './http';
8
8
 
@@ -23,10 +23,10 @@ async function main() {
23
23
 
24
24
  switch (options.transport) {
25
25
  case 'stdio':
26
- await launchStdioServer(options, selectedTools);
26
+ await launchStdioServer(options);
27
27
  break;
28
28
  case 'http':
29
- await launchStreamableHTTPServer(options, selectedTools, options.port ?? options.socket);
29
+ await launchStreamableHTTPServer(options, options.port ?? options.socket);
30
30
  break;
31
31
  }
32
32
  }
@@ -40,7 +40,7 @@ if (require.main === module) {
40
40
 
41
41
  function parseOptionsOrError() {
42
42
  try {
43
- return parseOptions();
43
+ return parseCLIOptions();
44
44
  } catch (error) {
45
45
  console.error('Error parsing options:', error);
46
46
  process.exit(1);