@stigg/typescript-mcp 0.1.0-alpha.8

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 (112) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +99 -0
  3. package/auth.d.mts +6 -0
  4. package/auth.d.mts.map +1 -0
  5. package/auth.d.ts +6 -0
  6. package/auth.d.ts.map +1 -0
  7. package/auth.js +22 -0
  8. package/auth.js.map +1 -0
  9. package/auth.mjs +17 -0
  10. package/auth.mjs.map +1 -0
  11. package/code-tool-types.d.mts +14 -0
  12. package/code-tool-types.d.mts.map +1 -0
  13. package/code-tool-types.d.ts +14 -0
  14. package/code-tool-types.d.ts.map +1 -0
  15. package/code-tool-types.js +4 -0
  16. package/code-tool-types.js.map +1 -0
  17. package/code-tool-types.mjs +3 -0
  18. package/code-tool-types.mjs.map +1 -0
  19. package/code-tool.d.mts +15 -0
  20. package/code-tool.d.mts.map +1 -0
  21. package/code-tool.d.ts +15 -0
  22. package/code-tool.d.ts.map +1 -0
  23. package/code-tool.js +108 -0
  24. package/code-tool.js.map +1 -0
  25. package/code-tool.mjs +105 -0
  26. package/code-tool.mjs.map +1 -0
  27. package/docs-search-tool.d.mts +57 -0
  28. package/docs-search-tool.d.mts.map +1 -0
  29. package/docs-search-tool.d.ts +57 -0
  30. package/docs-search-tool.d.ts.map +1 -0
  31. package/docs-search-tool.js +55 -0
  32. package/docs-search-tool.js.map +1 -0
  33. package/docs-search-tool.mjs +51 -0
  34. package/docs-search-tool.mjs.map +1 -0
  35. package/http.d.mts +14 -0
  36. package/http.d.mts.map +1 -0
  37. package/http.d.ts +14 -0
  38. package/http.d.ts.map +1 -0
  39. package/http.js +107 -0
  40. package/http.js.map +1 -0
  41. package/http.mjs +99 -0
  42. package/http.mjs.map +1 -0
  43. package/index.d.mts +3 -0
  44. package/index.d.mts.map +1 -0
  45. package/index.d.ts +3 -0
  46. package/index.d.ts.map +1 -0
  47. package/index.js +59 -0
  48. package/index.js.map +1 -0
  49. package/index.mjs +57 -0
  50. package/index.mjs.map +1 -0
  51. package/methods.d.mts +10 -0
  52. package/methods.d.mts.map +1 -0
  53. package/methods.d.ts +10 -0
  54. package/methods.d.ts.map +1 -0
  55. package/methods.js +419 -0
  56. package/methods.js.map +1 -0
  57. package/methods.mjs +415 -0
  58. package/methods.mjs.map +1 -0
  59. package/options.d.mts +16 -0
  60. package/options.d.mts.map +1 -0
  61. package/options.d.ts +16 -0
  62. package/options.d.ts.map +1 -0
  63. package/options.js +99 -0
  64. package/options.js.map +1 -0
  65. package/options.mjs +92 -0
  66. package/options.mjs.map +1 -0
  67. package/package.json +185 -0
  68. package/server.d.mts +29 -0
  69. package/server.d.mts.map +1 -0
  70. package/server.d.ts +29 -0
  71. package/server.d.ts.map +1 -0
  72. package/server.js +143 -0
  73. package/server.js.map +1 -0
  74. package/server.mjs +133 -0
  75. package/server.mjs.map +1 -0
  76. package/src/auth.ts +25 -0
  77. package/src/code-tool-types.ts +16 -0
  78. package/src/code-tool.ts +139 -0
  79. package/src/docs-search-tool.ts +68 -0
  80. package/src/http.ts +138 -0
  81. package/src/index.ts +65 -0
  82. package/src/methods.ts +440 -0
  83. package/src/options.ts +129 -0
  84. package/src/server.ts +181 -0
  85. package/src/stdio.ts +13 -0
  86. package/src/tsconfig.json +11 -0
  87. package/src/types.ts +123 -0
  88. package/src/util.ts +25 -0
  89. package/stdio.d.mts +3 -0
  90. package/stdio.d.mts.map +1 -0
  91. package/stdio.d.ts +3 -0
  92. package/stdio.d.ts.map +1 -0
  93. package/stdio.js +14 -0
  94. package/stdio.js.map +1 -0
  95. package/stdio.mjs +10 -0
  96. package/stdio.mjs.map +1 -0
  97. package/types.d.mts +59 -0
  98. package/types.d.mts.map +1 -0
  99. package/types.d.ts +59 -0
  100. package/types.d.ts.map +1 -0
  101. package/types.js +58 -0
  102. package/types.js.map +1 -0
  103. package/types.mjs +53 -0
  104. package/types.mjs.map +1 -0
  105. package/util.d.mts +4 -0
  106. package/util.d.mts.map +1 -0
  107. package/util.d.ts +4 -0
  108. package/util.d.ts.map +1 -0
  109. package/util.js +30 -0
  110. package/util.js.map +1 -0
  111. package/util.mjs +24 -0
  112. package/util.mjs.map +1 -0
package/options.mjs ADDED
@@ -0,0 +1,92 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+ import qs from 'qs';
3
+ import yargs from 'yargs';
4
+ import { hideBin } from 'yargs/helpers';
5
+ import z from 'zod';
6
+ import { readEnv } from "./util.mjs";
7
+ export function parseCLIOptions() {
8
+ const opts = yargs(hideBin(process.argv))
9
+ .option('code-allow-http-gets', {
10
+ type: 'boolean',
11
+ description: 'Allow all code tool methods that map to HTTP GET operations. If all code-allow-* flags are unset, then everything is allowed.',
12
+ })
13
+ .option('code-allowed-methods', {
14
+ type: 'string',
15
+ array: true,
16
+ description: 'Methods to explicitly allow for code tool. Evaluated as regular expressions against method fully qualified names. If all code-allow-* flags are unset, then everything is allowed.',
17
+ })
18
+ .option('code-blocked-methods', {
19
+ type: 'string',
20
+ array: true,
21
+ description: 'Methods to explicitly block for code tool. Evaluated as regular expressions against method fully qualified names. If all code-allow-* flags are unset, then everything is allowed.',
22
+ })
23
+ .option('debug', { type: 'boolean', description: 'Enable debug logging' })
24
+ .option('no-tools', {
25
+ type: 'string',
26
+ array: true,
27
+ choices: ['code', 'docs'],
28
+ description: 'Tools to explicitly disable',
29
+ })
30
+ .option('port', {
31
+ type: 'number',
32
+ default: 3000,
33
+ description: 'Port to serve on if using http transport',
34
+ })
35
+ .option('socket', { type: 'string', description: 'Unix socket to serve on if using http transport' })
36
+ .option('stainless-api-key', {
37
+ type: 'string',
38
+ default: readEnv('STAINLESS_API_KEY'),
39
+ description: 'API key for Stainless. Used to authenticate requests to Stainless-hosted tools endpoints.',
40
+ })
41
+ .option('tools', {
42
+ type: 'string',
43
+ array: true,
44
+ choices: ['code', 'docs'],
45
+ description: 'Tools to explicitly enable',
46
+ })
47
+ .option('transport', {
48
+ type: 'string',
49
+ choices: ['stdio', 'http'],
50
+ default: 'stdio',
51
+ description: 'What transport to use; stdio for local servers or http for remote servers',
52
+ })
53
+ .env('MCP_SERVER')
54
+ .version(true)
55
+ .help();
56
+ const argv = opts.parseSync();
57
+ const shouldIncludeToolType = (toolType) => argv.noTools?.includes(toolType) ? false
58
+ : argv.tools?.includes(toolType) ? true
59
+ : undefined;
60
+ const includeDocsTools = shouldIncludeToolType('docs');
61
+ const transport = argv.transport;
62
+ return {
63
+ ...(includeDocsTools !== undefined && { includeDocsTools }),
64
+ debug: !!argv.debug,
65
+ stainlessApiKey: argv.stainlessApiKey,
66
+ codeAllowHttpGets: argv.codeAllowHttpGets,
67
+ codeAllowedMethods: argv.codeAllowedMethods,
68
+ codeBlockedMethods: argv.codeBlockedMethods,
69
+ transport,
70
+ port: argv.port,
71
+ socket: argv.socket,
72
+ };
73
+ }
74
+ const coerceArray = (zodType) => z.preprocess((val) => Array.isArray(val) ? val
75
+ : val ? [val]
76
+ : val, z.array(zodType).optional());
77
+ const QueryOptions = z.object({
78
+ tools: coerceArray(z.enum(['code', 'docs'])).describe('Specify which MCP tools to use'),
79
+ no_tools: coerceArray(z.enum(['code', 'docs'])).describe('Specify which MCP tools to not use.'),
80
+ tool: coerceArray(z.string()).describe('Include tools matching the specified names'),
81
+ });
82
+ export function parseQueryOptions(defaultOptions, query) {
83
+ const queryObject = typeof query === 'string' ? qs.parse(query) : query;
84
+ const queryOptions = QueryOptions.parse(queryObject);
85
+ let docsTools = queryOptions.no_tools && queryOptions.no_tools?.includes('docs') ? false
86
+ : queryOptions.tools?.includes('docs') ? true
87
+ : defaultOptions.includeDocsTools;
88
+ return {
89
+ ...(docsTools !== undefined && { includeDocsTools: docsTools }),
90
+ };
91
+ }
92
+ //# sourceMappingURL=options.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"options.mjs","sourceRoot":"","sources":["src/options.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,185 @@
1
+ {
2
+ "name": "@stigg/typescript-mcp",
3
+ "version": "0.1.0-alpha.8",
4
+ "description": "The official MCP Server for the Stigg API",
5
+ "author": "Stigg <>",
6
+ "types": "./index.d.ts",
7
+ "main": "./index.js",
8
+ "type": "commonjs",
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "git+https://github.com/stiggio/stigg-typescript.git",
12
+ "directory": "packages/mcp-server"
13
+ },
14
+ "homepage": "https://github.com/stiggio/stigg-typescript/tree/main/packages/mcp-server#readme",
15
+ "license": "Apache-2.0",
16
+ "packageManager": "yarn@1.22.22",
17
+ "private": false,
18
+ "publishConfig": {
19
+ "access": "public"
20
+ },
21
+ "scripts": {
22
+ "test": "jest",
23
+ "build": "bash ./build",
24
+ "format": "prettier --write --cache --cache-strategy metadata . !dist",
25
+ "tsn": "ts-node -r tsconfig-paths/register",
26
+ "lint": "eslint --ext ts,js .",
27
+ "fix": "eslint --fix --ext ts,js ."
28
+ },
29
+ "dependencies": {
30
+ "@stigg/typescript": "^0.1.0-alpha.8",
31
+ "@cloudflare/cabidela": "^0.2.4",
32
+ "@modelcontextprotocol/sdk": "^1.25.2",
33
+ "@valtown/deno-http-worker": "^0.0.21",
34
+ "cookie-parser": "^1.4.6",
35
+ "cors": "^2.8.5",
36
+ "express": "^5.1.0",
37
+ "fuse.js": "^7.1.0",
38
+ "jq-web": "https://github.com/stainless-api/jq-web/releases/download/v0.8.8/jq-web.tar.gz",
39
+ "morgan": "^1.10.0",
40
+ "morgan-body": "^2.6.9",
41
+ "qs": "^6.14.1",
42
+ "typescript": "5.8.3",
43
+ "yargs": "^17.7.2",
44
+ "zod": "^3.25.20",
45
+ "zod-to-json-schema": "^3.24.5",
46
+ "zod-validation-error": "^4.0.1"
47
+ },
48
+ "bin": {
49
+ "mcp-server": "./index.js"
50
+ },
51
+ "imports": {
52
+ "@stigg/typescript-mcp": ".",
53
+ "@stigg/typescript-mcp/*": "./src/*"
54
+ },
55
+ "exports": {
56
+ ".": {
57
+ "require": {
58
+ "types": "./index.d.ts",
59
+ "default": "./index.js"
60
+ },
61
+ "types": "./index.d.mts",
62
+ "default": "./index.mjs"
63
+ },
64
+ "./auth": {
65
+ "import": "./auth.mjs",
66
+ "require": "./auth.js"
67
+ },
68
+ "./auth.js": {
69
+ "default": "./auth.js"
70
+ },
71
+ "./auth.mjs": {
72
+ "default": "./auth.mjs"
73
+ },
74
+ "./code-tool-types": {
75
+ "import": "./code-tool-types.mjs",
76
+ "require": "./code-tool-types.js"
77
+ },
78
+ "./code-tool-types.js": {
79
+ "default": "./code-tool-types.js"
80
+ },
81
+ "./code-tool-types.mjs": {
82
+ "default": "./code-tool-types.mjs"
83
+ },
84
+ "./code-tool": {
85
+ "import": "./code-tool.mjs",
86
+ "require": "./code-tool.js"
87
+ },
88
+ "./code-tool.js": {
89
+ "default": "./code-tool.js"
90
+ },
91
+ "./code-tool.mjs": {
92
+ "default": "./code-tool.mjs"
93
+ },
94
+ "./docs-search-tool": {
95
+ "import": "./docs-search-tool.mjs",
96
+ "require": "./docs-search-tool.js"
97
+ },
98
+ "./docs-search-tool.js": {
99
+ "default": "./docs-search-tool.js"
100
+ },
101
+ "./docs-search-tool.mjs": {
102
+ "default": "./docs-search-tool.mjs"
103
+ },
104
+ "./http": {
105
+ "import": "./http.mjs",
106
+ "require": "./http.js"
107
+ },
108
+ "./http.js": {
109
+ "default": "./http.js"
110
+ },
111
+ "./http.mjs": {
112
+ "default": "./http.mjs"
113
+ },
114
+ "./index": {
115
+ "import": "./index.mjs",
116
+ "require": "./index.js"
117
+ },
118
+ "./index.js": {
119
+ "default": "./index.js"
120
+ },
121
+ "./index.mjs": {
122
+ "default": "./index.mjs"
123
+ },
124
+ "./methods": {
125
+ "import": "./methods.mjs",
126
+ "require": "./methods.js"
127
+ },
128
+ "./methods.js": {
129
+ "default": "./methods.js"
130
+ },
131
+ "./methods.mjs": {
132
+ "default": "./methods.mjs"
133
+ },
134
+ "./options": {
135
+ "import": "./options.mjs",
136
+ "require": "./options.js"
137
+ },
138
+ "./options.js": {
139
+ "default": "./options.js"
140
+ },
141
+ "./options.mjs": {
142
+ "default": "./options.mjs"
143
+ },
144
+ "./server": {
145
+ "import": "./server.mjs",
146
+ "require": "./server.js"
147
+ },
148
+ "./server.js": {
149
+ "default": "./server.js"
150
+ },
151
+ "./server.mjs": {
152
+ "default": "./server.mjs"
153
+ },
154
+ "./stdio": {
155
+ "import": "./stdio.mjs",
156
+ "require": "./stdio.js"
157
+ },
158
+ "./stdio.js": {
159
+ "default": "./stdio.js"
160
+ },
161
+ "./stdio.mjs": {
162
+ "default": "./stdio.mjs"
163
+ },
164
+ "./types": {
165
+ "import": "./types.mjs",
166
+ "require": "./types.js"
167
+ },
168
+ "./types.js": {
169
+ "default": "./types.js"
170
+ },
171
+ "./types.mjs": {
172
+ "default": "./types.mjs"
173
+ },
174
+ "./util": {
175
+ "import": "./util.mjs",
176
+ "require": "./util.js"
177
+ },
178
+ "./util.js": {
179
+ "default": "./util.js"
180
+ },
181
+ "./util.mjs": {
182
+ "default": "./util.mjs"
183
+ }
184
+ }
185
+ }
package/server.d.mts ADDED
@@ -0,0 +1,29 @@
1
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
+ import { ClientOptions } from '@stigg/typescript';
4
+ import { McpOptions } from "./options.mjs";
5
+ import { HandlerFunction, McpRequestContext, ToolCallResult, McpTool } from "./types.mjs";
6
+ export declare const newMcpServer: (stainlessApiKey: string | undefined) => Promise<McpServer>;
7
+ /**
8
+ * Initializes the provided MCP Server with the given tools and handlers.
9
+ * If not provided, the default client, tools and handlers will be used.
10
+ */
11
+ export declare function initMcpServer(params: {
12
+ server: Server | McpServer;
13
+ clientOptions?: ClientOptions;
14
+ mcpOptions?: McpOptions;
15
+ stainlessApiKey?: string | undefined;
16
+ }): Promise<void>;
17
+ /**
18
+ * Selects the tools to include in the MCP Server based on the provided options.
19
+ */
20
+ export declare function selectTools(options?: McpOptions): McpTool[];
21
+ /**
22
+ * Runs the provided handler with the given client and arguments.
23
+ */
24
+ export declare function executeHandler({ handler, reqContext, args, }: {
25
+ handler: HandlerFunction;
26
+ reqContext: McpRequestContext;
27
+ args: Record<string, unknown> | undefined;
28
+ }): Promise<ToolCallResult>;
29
+ //# sourceMappingURL=server.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.mts","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE,MAAM,2CAA2C;OAC3D,EAAE,SAAS,EAAE,MAAM,yCAAyC;OAM5D,EAAE,aAAa,EAAE,MAAM,mBAAmB;OAI1C,EAAE,UAAU,EAAE;OAEd,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE;AAuCtE,eAAO,MAAM,YAAY,GAAU,iBAAiB,MAAM,GAAG,SAAS,uBAUnE,CAAC;AAEJ;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,iBA2EA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAU3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EACnC,OAAO,EACP,UAAU,EACV,IAAI,GACL,EAAE;IACD,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C,GAAG,OAAO,CAAC,cAAc,CAAC,CAE1B"}
package/server.d.ts ADDED
@@ -0,0 +1,29 @@
1
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
+ import { ClientOptions } from '@stigg/typescript';
4
+ import { McpOptions } from "./options.js";
5
+ import { HandlerFunction, McpRequestContext, ToolCallResult, McpTool } from "./types.js";
6
+ export declare const newMcpServer: (stainlessApiKey: string | undefined) => Promise<McpServer>;
7
+ /**
8
+ * Initializes the provided MCP Server with the given tools and handlers.
9
+ * If not provided, the default client, tools and handlers will be used.
10
+ */
11
+ export declare function initMcpServer(params: {
12
+ server: Server | McpServer;
13
+ clientOptions?: ClientOptions;
14
+ mcpOptions?: McpOptions;
15
+ stainlessApiKey?: string | undefined;
16
+ }): Promise<void>;
17
+ /**
18
+ * Selects the tools to include in the MCP Server based on the provided options.
19
+ */
20
+ export declare function selectTools(options?: McpOptions): McpTool[];
21
+ /**
22
+ * Runs the provided handler with the given client and arguments.
23
+ */
24
+ export declare function executeHandler({ handler, reqContext, args, }: {
25
+ handler: HandlerFunction;
26
+ reqContext: McpRequestContext;
27
+ args: Record<string, unknown> | undefined;
28
+ }): Promise<ToolCallResult>;
29
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"OAEO,EAAE,MAAM,EAAE,MAAM,2CAA2C;OAC3D,EAAE,SAAS,EAAE,MAAM,yCAAyC;OAM5D,EAAE,aAAa,EAAE,MAAM,mBAAmB;OAI1C,EAAE,UAAU,EAAE;OAEd,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE;AAuCtE,eAAO,MAAM,YAAY,GAAU,iBAAiB,MAAM,GAAG,SAAS,uBAUnE,CAAC;AAEJ;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,iBA2EA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAU3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EACnC,OAAO,EACP,UAAU,EACV,IAAI,GACL,EAAE;IACD,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C,GAAG,OAAO,CAAC,cAAc,CAAC,CAE1B"}
package/server.js ADDED
@@ -0,0 +1,143 @@
1
+ "use strict";
2
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
3
+ var __importDefault = (this && this.__importDefault) || function (mod) {
4
+ return (mod && mod.__esModule) ? mod : { "default": mod };
5
+ };
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.newMcpServer = void 0;
8
+ exports.initMcpServer = initMcpServer;
9
+ exports.selectTools = selectTools;
10
+ exports.executeHandler = executeHandler;
11
+ const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
12
+ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
13
+ const typescript_1 = __importDefault(require("@stigg/typescript"));
14
+ const code_tool_1 = require("./code-tool.js");
15
+ const docs_search_tool_1 = __importDefault(require("./docs-search-tool.js"));
16
+ const methods_1 = require("./methods.js");
17
+ const util_1 = require("./util.js");
18
+ async function getInstructions(stainlessApiKey) {
19
+ // Setting the stainless API key is optional, but may be required
20
+ // to authenticate requests to the Stainless API.
21
+ const response = await fetch((0, util_1.readEnv)('CODE_MODE_INSTRUCTIONS_URL') ?? 'https://api.stainless.com/api/ai/instructions/stigg', {
22
+ method: 'GET',
23
+ headers: { ...(stainlessApiKey && { Authorization: stainlessApiKey }) },
24
+ });
25
+ let instructions;
26
+ if (!response.ok) {
27
+ console.warn('Warning: failed to retrieve MCP server instructions. Proceeding with default instructions...');
28
+ instructions = `
29
+ This is the stigg MCP server. You will use Code Mode to help the user perform
30
+ actions. You can use search_docs tool to learn about how to take action with this server. Then,
31
+ you will write TypeScript code using the execute tool take action. It is CRITICAL that you be
32
+ thoughtful and deliberate when executing code. Always try to entirely solve the problem in code
33
+ block: it can be as long as you need to get the job done!
34
+ `;
35
+ }
36
+ instructions ??= (await response.json()).instructions;
37
+ instructions = `
38
+ The current time in Unix timestamps is ${Date.now()}.
39
+
40
+ ${instructions}
41
+ `;
42
+ return instructions;
43
+ }
44
+ const newMcpServer = async (stainlessApiKey) => new mcp_js_1.McpServer({
45
+ name: 'stigg_typescript_api',
46
+ version: '0.1.0-alpha.8',
47
+ }, {
48
+ instructions: await getInstructions(stainlessApiKey),
49
+ capabilities: { tools: {}, logging: {} },
50
+ });
51
+ exports.newMcpServer = newMcpServer;
52
+ /**
53
+ * Initializes the provided MCP Server with the given tools and handlers.
54
+ * If not provided, the default client, tools and handlers will be used.
55
+ */
56
+ async function initMcpServer(params) {
57
+ const server = params.server instanceof mcp_js_1.McpServer ? params.server.server : params.server;
58
+ const logAtLevel = (level) => (message, ...rest) => {
59
+ void server.sendLoggingMessage({
60
+ level,
61
+ data: { message, rest },
62
+ });
63
+ };
64
+ const logger = {
65
+ debug: logAtLevel('debug'),
66
+ info: logAtLevel('info'),
67
+ warn: logAtLevel('warning'),
68
+ error: logAtLevel('error'),
69
+ };
70
+ let client = new typescript_1.default({
71
+ logger,
72
+ ...params.clientOptions,
73
+ defaultHeaders: {
74
+ ...params.clientOptions?.defaultHeaders,
75
+ 'X-Stainless-MCP': 'true',
76
+ },
77
+ });
78
+ const providedTools = selectTools(params.mcpOptions);
79
+ const toolMap = Object.fromEntries(providedTools.map((mcpTool) => [mcpTool.tool.name, mcpTool]));
80
+ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
81
+ return {
82
+ tools: providedTools.map((mcpTool) => mcpTool.tool),
83
+ };
84
+ });
85
+ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
86
+ const { name, arguments: args } = request.params;
87
+ const mcpTool = toolMap[name];
88
+ if (!mcpTool) {
89
+ throw new Error(`Unknown tool: ${name}`);
90
+ }
91
+ return executeHandler({
92
+ handler: mcpTool.handler,
93
+ reqContext: {
94
+ client,
95
+ stainlessApiKey: params.stainlessApiKey ?? params.mcpOptions?.stainlessApiKey,
96
+ },
97
+ args,
98
+ });
99
+ });
100
+ server.setRequestHandler(types_js_1.SetLevelRequestSchema, async (request) => {
101
+ const { level } = request.params;
102
+ switch (level) {
103
+ case 'debug':
104
+ client = client.withOptions({ logLevel: 'debug' });
105
+ break;
106
+ case 'info':
107
+ client = client.withOptions({ logLevel: 'info' });
108
+ break;
109
+ case 'notice':
110
+ case 'warning':
111
+ client = client.withOptions({ logLevel: 'warn' });
112
+ break;
113
+ case 'error':
114
+ client = client.withOptions({ logLevel: 'error' });
115
+ break;
116
+ default:
117
+ client = client.withOptions({ logLevel: 'off' });
118
+ break;
119
+ }
120
+ return {};
121
+ });
122
+ }
123
+ /**
124
+ * Selects the tools to include in the MCP Server based on the provided options.
125
+ */
126
+ function selectTools(options) {
127
+ const includedTools = [
128
+ (0, code_tool_1.codeTool)({
129
+ blockedMethods: (0, methods_1.blockedMethodsForCodeTool)(options),
130
+ }),
131
+ ];
132
+ if (options?.includeDocsTools ?? true) {
133
+ includedTools.push(docs_search_tool_1.default);
134
+ }
135
+ return includedTools;
136
+ }
137
+ /**
138
+ * Runs the provided handler with the given client and arguments.
139
+ */
140
+ async function executeHandler({ handler, reqContext, args, }) {
141
+ return await handler({ reqContext, args: args || {} });
142
+ }
143
+ //# sourceMappingURL=server.js.map
package/server.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"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"}
package/server.mjs ADDED
@@ -0,0 +1,133 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
+ import { CallToolRequestSchema, ListToolsRequestSchema, SetLevelRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
4
+ import Stigg from '@stigg/typescript';
5
+ import { codeTool } from "./code-tool.mjs";
6
+ import docsSearchTool from "./docs-search-tool.mjs";
7
+ import { blockedMethodsForCodeTool } from "./methods.mjs";
8
+ import { readEnv } from "./util.mjs";
9
+ async function getInstructions(stainlessApiKey) {
10
+ // Setting the stainless API key is optional, but may be required
11
+ // to authenticate requests to the Stainless API.
12
+ const response = await fetch(readEnv('CODE_MODE_INSTRUCTIONS_URL') ?? 'https://api.stainless.com/api/ai/instructions/stigg', {
13
+ method: 'GET',
14
+ headers: { ...(stainlessApiKey && { Authorization: stainlessApiKey }) },
15
+ });
16
+ let instructions;
17
+ if (!response.ok) {
18
+ console.warn('Warning: failed to retrieve MCP server instructions. Proceeding with default instructions...');
19
+ instructions = `
20
+ This is the stigg MCP server. You will use Code Mode to help the user perform
21
+ actions. You can use search_docs tool to learn about how to take action with this server. Then,
22
+ you will write TypeScript code using the execute tool take action. It is CRITICAL that you be
23
+ thoughtful and deliberate when executing code. Always try to entirely solve the problem in code
24
+ block: it can be as long as you need to get the job done!
25
+ `;
26
+ }
27
+ instructions ??= (await response.json()).instructions;
28
+ instructions = `
29
+ The current time in Unix timestamps is ${Date.now()}.
30
+
31
+ ${instructions}
32
+ `;
33
+ return instructions;
34
+ }
35
+ export const newMcpServer = async (stainlessApiKey) => new McpServer({
36
+ name: 'stigg_typescript_api',
37
+ version: '0.1.0-alpha.8',
38
+ }, {
39
+ instructions: await getInstructions(stainlessApiKey),
40
+ capabilities: { tools: {}, logging: {} },
41
+ });
42
+ /**
43
+ * Initializes the provided MCP Server with the given tools and handlers.
44
+ * If not provided, the default client, tools and handlers will be used.
45
+ */
46
+ export async function initMcpServer(params) {
47
+ const server = params.server instanceof McpServer ? params.server.server : params.server;
48
+ const logAtLevel = (level) => (message, ...rest) => {
49
+ void server.sendLoggingMessage({
50
+ level,
51
+ data: { message, rest },
52
+ });
53
+ };
54
+ const logger = {
55
+ debug: logAtLevel('debug'),
56
+ info: logAtLevel('info'),
57
+ warn: logAtLevel('warning'),
58
+ error: logAtLevel('error'),
59
+ };
60
+ let client = new Stigg({
61
+ logger,
62
+ ...params.clientOptions,
63
+ defaultHeaders: {
64
+ ...params.clientOptions?.defaultHeaders,
65
+ 'X-Stainless-MCP': 'true',
66
+ },
67
+ });
68
+ const providedTools = selectTools(params.mcpOptions);
69
+ const toolMap = Object.fromEntries(providedTools.map((mcpTool) => [mcpTool.tool.name, mcpTool]));
70
+ server.setRequestHandler(ListToolsRequestSchema, async () => {
71
+ return {
72
+ tools: providedTools.map((mcpTool) => mcpTool.tool),
73
+ };
74
+ });
75
+ server.setRequestHandler(CallToolRequestSchema, async (request) => {
76
+ const { name, arguments: args } = request.params;
77
+ const mcpTool = toolMap[name];
78
+ if (!mcpTool) {
79
+ throw new Error(`Unknown tool: ${name}`);
80
+ }
81
+ return executeHandler({
82
+ handler: mcpTool.handler,
83
+ reqContext: {
84
+ client,
85
+ stainlessApiKey: params.stainlessApiKey ?? params.mcpOptions?.stainlessApiKey,
86
+ },
87
+ args,
88
+ });
89
+ });
90
+ server.setRequestHandler(SetLevelRequestSchema, async (request) => {
91
+ const { level } = request.params;
92
+ switch (level) {
93
+ case 'debug':
94
+ client = client.withOptions({ logLevel: 'debug' });
95
+ break;
96
+ case 'info':
97
+ client = client.withOptions({ logLevel: 'info' });
98
+ break;
99
+ case 'notice':
100
+ case 'warning':
101
+ client = client.withOptions({ logLevel: 'warn' });
102
+ break;
103
+ case 'error':
104
+ client = client.withOptions({ logLevel: 'error' });
105
+ break;
106
+ default:
107
+ client = client.withOptions({ logLevel: 'off' });
108
+ break;
109
+ }
110
+ return {};
111
+ });
112
+ }
113
+ /**
114
+ * Selects the tools to include in the MCP Server based on the provided options.
115
+ */
116
+ export function selectTools(options) {
117
+ const includedTools = [
118
+ codeTool({
119
+ blockedMethods: blockedMethodsForCodeTool(options),
120
+ }),
121
+ ];
122
+ if (options?.includeDocsTools ?? true) {
123
+ includedTools.push(docsSearchTool);
124
+ }
125
+ return includedTools;
126
+ }
127
+ /**
128
+ * Runs the provided handler with the given client and arguments.
129
+ */
130
+ export async function executeHandler({ handler, reqContext, args, }) {
131
+ return await handler({ reqContext, args: args || {} });
132
+ }
133
+ //# sourceMappingURL=server.mjs.map
package/server.mjs.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.mjs","sourceRoot":"","sources":["src/server.ts"],"names":[],"mappings":"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"}