@roarkanalytics/sdk-mcp 2.19.1 → 2.23.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 (101) hide show
  1. package/README.md +1 -1
  2. package/auth.d.mts +6 -0
  3. package/auth.d.mts.map +1 -0
  4. package/auth.d.ts +6 -0
  5. package/auth.d.ts.map +1 -0
  6. package/{headers.mjs → auth.js} +18 -2
  7. package/auth.js.map +1 -0
  8. package/{headers.js → auth.mjs} +13 -6
  9. package/auth.mjs.map +1 -0
  10. package/code-tool.d.mts +4 -1
  11. package/code-tool.d.mts.map +1 -1
  12. package/code-tool.d.ts +4 -1
  13. package/code-tool.d.ts.map +1 -1
  14. package/code-tool.js +22 -10
  15. package/code-tool.js.map +1 -1
  16. package/code-tool.mjs +20 -8
  17. package/code-tool.mjs.map +1 -1
  18. package/docs-search-tool.d.mts +9 -3
  19. package/docs-search-tool.d.mts.map +1 -1
  20. package/docs-search-tool.d.ts +9 -3
  21. package/docs-search-tool.d.ts.map +1 -1
  22. package/docs-search-tool.js +6 -2
  23. package/docs-search-tool.js.map +1 -1
  24. package/docs-search-tool.mjs +6 -2
  25. package/docs-search-tool.mjs.map +1 -1
  26. package/http.d.mts +2 -2
  27. package/http.d.mts.map +1 -1
  28. package/http.d.ts +2 -2
  29. package/http.d.ts.map +1 -1
  30. package/http.js +11 -8
  31. package/http.js.map +1 -1
  32. package/http.mjs +11 -8
  33. package/http.mjs.map +1 -1
  34. package/index.js +1 -1
  35. package/index.js.map +1 -1
  36. package/index.mjs +1 -1
  37. package/index.mjs.map +1 -1
  38. package/methods.d.mts +10 -0
  39. package/methods.d.mts.map +1 -0
  40. package/methods.d.ts +10 -0
  41. package/methods.d.ts.map +1 -0
  42. package/methods.js +383 -0
  43. package/methods.js.map +1 -0
  44. package/methods.mjs +379 -0
  45. package/methods.mjs.map +1 -0
  46. package/options.d.mts +4 -0
  47. package/options.d.mts.map +1 -1
  48. package/options.d.ts +4 -0
  49. package/options.d.ts.map +1 -1
  50. package/options.js +25 -0
  51. package/options.js.map +1 -1
  52. package/options.mjs +25 -0
  53. package/options.mjs.map +1 -1
  54. package/package.json +134 -17
  55. package/server.d.mts +8 -9
  56. package/server.d.mts.map +1 -1
  57. package/server.d.ts +8 -9
  58. package/server.d.ts.map +1 -1
  59. package/server.js +62 -39
  60. package/server.js.map +1 -1
  61. package/server.mjs +61 -35
  62. package/server.mjs.map +1 -1
  63. package/src/{headers.ts → auth.ts} +16 -1
  64. package/src/code-tool.ts +37 -9
  65. package/src/docs-search-tool.ts +13 -4
  66. package/src/http.ts +19 -8
  67. package/src/index.ts +1 -1
  68. package/src/methods.ts +404 -0
  69. package/src/options.ts +34 -0
  70. package/src/server.ts +79 -45
  71. package/src/stdio.ts +4 -3
  72. package/src/types.ts +12 -4
  73. package/src/util.ts +25 -0
  74. package/stdio.d.mts +2 -1
  75. package/stdio.d.mts.map +1 -1
  76. package/stdio.d.ts +2 -1
  77. package/stdio.d.ts.map +1 -1
  78. package/stdio.js +3 -3
  79. package/stdio.js.map +1 -1
  80. package/stdio.mjs +3 -3
  81. package/stdio.mjs.map +1 -1
  82. package/types.d.mts +8 -1
  83. package/types.d.mts.map +1 -1
  84. package/types.d.ts +8 -1
  85. package/types.d.ts.map +1 -1
  86. package/types.js.map +1 -1
  87. package/types.mjs.map +1 -1
  88. package/util.d.mts +4 -0
  89. package/util.d.mts.map +1 -0
  90. package/util.d.ts +4 -0
  91. package/util.d.ts.map +1 -0
  92. package/util.js +30 -0
  93. package/util.js.map +1 -0
  94. package/util.mjs +24 -0
  95. package/util.mjs.map +1 -0
  96. package/headers.d.mts +0 -4
  97. package/headers.d.mts.map +0 -1
  98. package/headers.d.ts +0 -4
  99. package/headers.d.ts.map +0 -1
  100. package/headers.js.map +0 -1
  101. package/headers.mjs.map +0 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@roarkanalytics/sdk-mcp",
3
- "version": "2.19.1",
3
+ "version": "2.23.0",
4
4
  "description": "The official MCP Server for the Roark API",
5
5
  "author": "Roark <james@roark.ai>",
6
6
  "types": "./index.d.ts",
@@ -13,21 +13,12 @@
13
13
  },
14
14
  "homepage": "https://github.com/roarkhq/sdk-roark-analytics-node/tree/main/packages/mcp-server#readme",
15
15
  "license": "Apache-2.0",
16
- "packageManager": "yarn@1.22.22",
17
16
  "private": false,
18
17
  "publishConfig": {
19
18
  "access": "public"
20
19
  },
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
20
  "dependencies": {
30
- "@roarkanalytics/sdk": "^2.19.1",
21
+ "@roarkanalytics/sdk": "^2.23.0",
31
22
  "@cloudflare/cabidela": "^0.2.4",
32
23
  "@modelcontextprotocol/sdk": "^1.25.2",
33
24
  "@valtown/deno-http-worker": "^0.0.21",
@@ -54,14 +45,140 @@
54
45
  },
55
46
  "exports": {
56
47
  ".": {
57
- "require": "./index.js",
48
+ "require": {
49
+ "types": "./index.d.ts",
50
+ "default": "./index.js"
51
+ },
52
+ "types": "./index.d.mts",
53
+ "default": "./index.mjs"
54
+ },
55
+ "./auth": {
56
+ "import": "./auth.mjs",
57
+ "require": "./auth.js"
58
+ },
59
+ "./auth.js": {
60
+ "default": "./auth.js"
61
+ },
62
+ "./auth.mjs": {
63
+ "default": "./auth.mjs"
64
+ },
65
+ "./code-tool-types": {
66
+ "import": "./code-tool-types.mjs",
67
+ "require": "./code-tool-types.js"
68
+ },
69
+ "./code-tool-types.js": {
70
+ "default": "./code-tool-types.js"
71
+ },
72
+ "./code-tool-types.mjs": {
73
+ "default": "./code-tool-types.mjs"
74
+ },
75
+ "./code-tool": {
76
+ "import": "./code-tool.mjs",
77
+ "require": "./code-tool.js"
78
+ },
79
+ "./code-tool.js": {
80
+ "default": "./code-tool.js"
81
+ },
82
+ "./code-tool.mjs": {
83
+ "default": "./code-tool.mjs"
84
+ },
85
+ "./docs-search-tool": {
86
+ "import": "./docs-search-tool.mjs",
87
+ "require": "./docs-search-tool.js"
88
+ },
89
+ "./docs-search-tool.js": {
90
+ "default": "./docs-search-tool.js"
91
+ },
92
+ "./docs-search-tool.mjs": {
93
+ "default": "./docs-search-tool.mjs"
94
+ },
95
+ "./http": {
96
+ "import": "./http.mjs",
97
+ "require": "./http.js"
98
+ },
99
+ "./http.js": {
100
+ "default": "./http.js"
101
+ },
102
+ "./http.mjs": {
103
+ "default": "./http.mjs"
104
+ },
105
+ "./index": {
106
+ "import": "./index.mjs",
107
+ "require": "./index.js"
108
+ },
109
+ "./index.js": {
110
+ "default": "./index.js"
111
+ },
112
+ "./index.mjs": {
58
113
  "default": "./index.mjs"
59
114
  },
60
- "./*.mjs": "./*.mjs",
61
- "./*.js": "./*.js",
62
- "./*": {
63
- "require": "./*.js",
64
- "default": "./*.mjs"
115
+ "./methods": {
116
+ "import": "./methods.mjs",
117
+ "require": "./methods.js"
118
+ },
119
+ "./methods.js": {
120
+ "default": "./methods.js"
121
+ },
122
+ "./methods.mjs": {
123
+ "default": "./methods.mjs"
124
+ },
125
+ "./options": {
126
+ "import": "./options.mjs",
127
+ "require": "./options.js"
128
+ },
129
+ "./options.js": {
130
+ "default": "./options.js"
131
+ },
132
+ "./options.mjs": {
133
+ "default": "./options.mjs"
134
+ },
135
+ "./server": {
136
+ "import": "./server.mjs",
137
+ "require": "./server.js"
138
+ },
139
+ "./server.js": {
140
+ "default": "./server.js"
141
+ },
142
+ "./server.mjs": {
143
+ "default": "./server.mjs"
144
+ },
145
+ "./stdio": {
146
+ "import": "./stdio.mjs",
147
+ "require": "./stdio.js"
148
+ },
149
+ "./stdio.js": {
150
+ "default": "./stdio.js"
151
+ },
152
+ "./stdio.mjs": {
153
+ "default": "./stdio.mjs"
154
+ },
155
+ "./types": {
156
+ "import": "./types.mjs",
157
+ "require": "./types.js"
158
+ },
159
+ "./types.js": {
160
+ "default": "./types.js"
161
+ },
162
+ "./types.mjs": {
163
+ "default": "./types.mjs"
164
+ },
165
+ "./util": {
166
+ "import": "./util.mjs",
167
+ "require": "./util.js"
168
+ },
169
+ "./util.js": {
170
+ "default": "./util.js"
171
+ },
172
+ "./util.mjs": {
173
+ "default": "./util.mjs"
65
174
  }
175
+ },
176
+ "scripts": {
177
+ "test": "jest",
178
+ "build": "bash ./build",
179
+ "format": "prettier --write --cache --cache-strategy metadata . !dist",
180
+ "tsn": "ts-node -r tsconfig-paths/register",
181
+ "lint": "eslint --ext ts,js .",
182
+ "fix": "eslint --fix --ext ts,js ."
66
183
  }
67
184
  }
package/server.d.mts CHANGED
@@ -1,12 +1,9 @@
1
1
  import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2
2
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
3
  import { ClientOptions } from '@roarkanalytics/sdk';
4
- import Roark from '@roarkanalytics/sdk';
5
4
  import { McpOptions } from "./options.mjs";
6
- import { HandlerFunction, McpTool } from "./types.mjs";
7
- export { McpOptions } from "./options.mjs";
8
- export { ClientOptions } from '@roarkanalytics/sdk';
9
- export declare const newMcpServer: () => Promise<McpServer>;
5
+ import { HandlerFunction, McpRequestContext, ToolCallResult, McpTool } from "./types.mjs";
6
+ export declare const newMcpServer: (stainlessApiKey: string | undefined) => Promise<McpServer>;
10
7
  /**
11
8
  * Initializes the provided MCP Server with the given tools and handlers.
12
9
  * If not provided, the default client, tools and handlers will be used.
@@ -15,6 +12,7 @@ export declare function initMcpServer(params: {
15
12
  server: Server | McpServer;
16
13
  clientOptions?: ClientOptions;
17
14
  mcpOptions?: McpOptions;
15
+ stainlessApiKey?: string | undefined;
18
16
  }): Promise<void>;
19
17
  /**
20
18
  * Selects the tools to include in the MCP Server based on the provided options.
@@ -23,8 +21,9 @@ export declare function selectTools(options?: McpOptions): McpTool[];
23
21
  /**
24
22
  * Runs the provided handler with the given client and arguments.
25
23
  */
26
- export declare function executeHandler(handler: HandlerFunction, client: Roark, args: Record<string, unknown> | undefined): Promise<import("./types").ToolCallResult>;
27
- export declare const readEnv: (env: string) => string | undefined;
28
- export declare const readEnvOrError: (env: string) => string;
29
- export declare const requireValue: <T>(value: T | undefined, description: string) => T;
24
+ export declare function executeHandler({ handler, reqContext, args, }: {
25
+ handler: HandlerFunction;
26
+ reqContext: McpRequestContext;
27
+ args: Record<string, unknown> | undefined;
28
+ }): Promise<ToolCallResult>;
30
29
  //# sourceMappingURL=server.d.mts.map
package/server.d.mts.map CHANGED
@@ -1 +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;OAE5D,EAAE,aAAa,EAAE,MAAM,qBAAqB;OAC5C,KAAK,MAAM,qBAAqB;OAGhC,EAAE,UAAU,EAAE;OACd,EAAE,eAAe,EAAE,OAAO,EAAE;OAE5B,EAAE,UAAU,EAAE;OACd,EAAE,aAAa,EAAE,MAAM,qBAAqB;AAsCnD,eAAO,MAAM,YAAY,0BAUtB,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;CACzB,iBA6BA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAM3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,KAAK,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,6CAG1C;AAED,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAO9C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAM5C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,aAAa,MAAM,KAAG,CAK3E,CAAC"}
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,qBAAqB;OAI5C,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 CHANGED
@@ -1,12 +1,9 @@
1
1
  import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2
2
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
3
  import { ClientOptions } from '@roarkanalytics/sdk';
4
- import Roark from '@roarkanalytics/sdk';
5
4
  import { McpOptions } from "./options.js";
6
- import { HandlerFunction, McpTool } from "./types.js";
7
- export { McpOptions } from "./options.js";
8
- export { ClientOptions } from '@roarkanalytics/sdk';
9
- export declare const newMcpServer: () => Promise<McpServer>;
5
+ import { HandlerFunction, McpRequestContext, ToolCallResult, McpTool } from "./types.js";
6
+ export declare const newMcpServer: (stainlessApiKey: string | undefined) => Promise<McpServer>;
10
7
  /**
11
8
  * Initializes the provided MCP Server with the given tools and handlers.
12
9
  * If not provided, the default client, tools and handlers will be used.
@@ -15,6 +12,7 @@ export declare function initMcpServer(params: {
15
12
  server: Server | McpServer;
16
13
  clientOptions?: ClientOptions;
17
14
  mcpOptions?: McpOptions;
15
+ stainlessApiKey?: string | undefined;
18
16
  }): Promise<void>;
19
17
  /**
20
18
  * Selects the tools to include in the MCP Server based on the provided options.
@@ -23,8 +21,9 @@ export declare function selectTools(options?: McpOptions): McpTool[];
23
21
  /**
24
22
  * Runs the provided handler with the given client and arguments.
25
23
  */
26
- export declare function executeHandler(handler: HandlerFunction, client: Roark, args: Record<string, unknown> | undefined): Promise<import("./types").ToolCallResult>;
27
- export declare const readEnv: (env: string) => string | undefined;
28
- export declare const readEnvOrError: (env: string) => string;
29
- export declare const requireValue: <T>(value: T | undefined, description: string) => T;
24
+ export declare function executeHandler({ handler, reqContext, args, }: {
25
+ handler: HandlerFunction;
26
+ reqContext: McpRequestContext;
27
+ args: Record<string, unknown> | undefined;
28
+ }): Promise<ToolCallResult>;
30
29
  //# sourceMappingURL=server.d.ts.map
package/server.d.ts.map CHANGED
@@ -1 +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;OAE5D,EAAE,aAAa,EAAE,MAAM,qBAAqB;OAC5C,KAAK,MAAM,qBAAqB;OAGhC,EAAE,UAAU,EAAE;OACd,EAAE,eAAe,EAAE,OAAO,EAAE;OAE5B,EAAE,UAAU,EAAE;OACd,EAAE,aAAa,EAAE,MAAM,qBAAqB;AAsCnD,eAAO,MAAM,YAAY,0BAUtB,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;CACzB,iBA6BA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,EAAE,CAM3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,KAAK,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,6CAG1C;AAED,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAO9C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAM5C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,aAAa,MAAM,KAAG,CAK3E,CAAC"}
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,qBAAqB;OAI5C,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 CHANGED
@@ -4,7 +4,7 @@ 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.requireValue = exports.readEnvOrError = exports.readEnv = exports.newMcpServer = void 0;
7
+ exports.newMcpServer = void 0;
8
8
  exports.initMcpServer = initMcpServer;
9
9
  exports.selectTools = selectTools;
10
10
  exports.executeHandler = executeHandler;
@@ -13,12 +13,14 @@ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
13
13
  const sdk_1 = __importDefault(require("@roarkanalytics/sdk"));
14
14
  const code_tool_1 = require("./code-tool.js");
15
15
  const docs_search_tool_1 = __importDefault(require("./docs-search-tool.js"));
16
- async function getInstructions() {
17
- // This API key is optional; providing it allows the server to fetch instructions for unreleased versions.
18
- const stainlessAPIKey = (0, exports.readEnv)('STAINLESS_API_KEY');
19
- const response = await fetch((0, exports.readEnv)('CODE_MODE_INSTRUCTIONS_URL') ?? 'https://api.stainless.com/api/ai/instructions/roark-analytics', {
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/roark-analytics', {
20
22
  method: 'GET',
21
- headers: { ...(stainlessAPIKey && { Authorization: stainlessAPIKey }) },
23
+ headers: { ...(stainlessApiKey && { Authorization: stainlessApiKey }) },
22
24
  });
23
25
  let instructions;
24
26
  if (!response.ok) {
@@ -39,11 +41,11 @@ async function getInstructions() {
39
41
  `;
40
42
  return instructions;
41
43
  }
42
- const newMcpServer = async () => new mcp_js_1.McpServer({
44
+ const newMcpServer = async (stainlessApiKey) => new mcp_js_1.McpServer({
43
45
  name: 'roarkanalytics_sdk_api',
44
- version: '2.19.1',
46
+ version: '2.23.0',
45
47
  }, {
46
- instructions: await getInstructions(),
48
+ instructions: await getInstructions(stainlessApiKey),
47
49
  capabilities: { tools: {}, logging: {} },
48
50
  });
49
51
  exports.newMcpServer = newMcpServer;
@@ -53,7 +55,20 @@ exports.newMcpServer = newMcpServer;
53
55
  */
54
56
  async function initMcpServer(params) {
55
57
  const server = params.server instanceof mcp_js_1.McpServer ? params.server.server : params.server;
56
- const client = new sdk_1.default({
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 sdk_1.default({
71
+ logger,
57
72
  ...params.clientOptions,
58
73
  defaultHeaders: {
59
74
  ...params.clientOptions?.defaultHeaders,
@@ -73,14 +88,47 @@ async function initMcpServer(params) {
73
88
  if (!mcpTool) {
74
89
  throw new Error(`Unknown tool: ${name}`);
75
90
  }
76
- return executeHandler(mcpTool.handler, client, args);
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 {};
77
121
  });
78
122
  }
79
123
  /**
80
124
  * Selects the tools to include in the MCP Server based on the provided options.
81
125
  */
82
126
  function selectTools(options) {
83
- const includedTools = [(0, code_tool_1.codeTool)()];
127
+ const includedTools = [
128
+ (0, code_tool_1.codeTool)({
129
+ blockedMethods: (0, methods_1.blockedMethodsForCodeTool)(options),
130
+ }),
131
+ ];
84
132
  if (options?.includeDocsTools ?? true) {
85
133
  includedTools.push(docs_search_tool_1.default);
86
134
  }
@@ -89,32 +137,7 @@ function selectTools(options) {
89
137
  /**
90
138
  * Runs the provided handler with the given client and arguments.
91
139
  */
92
- async function executeHandler(handler, client, args) {
93
- return await handler(client, args || {});
140
+ async function executeHandler({ handler, reqContext, args, }) {
141
+ return await handler({ reqContext, args: args || {} });
94
142
  }
95
- const readEnv = (env) => {
96
- if (typeof globalThis.process !== 'undefined') {
97
- return globalThis.process.env?.[env]?.trim();
98
- }
99
- else if (typeof globalThis.Deno !== 'undefined') {
100
- return globalThis.Deno.env?.get?.(env)?.trim();
101
- }
102
- return;
103
- };
104
- exports.readEnv = readEnv;
105
- const readEnvOrError = (env) => {
106
- let envValue = (0, exports.readEnv)(env);
107
- if (envValue === undefined) {
108
- throw new Error(`Environment variable ${env} is not set`);
109
- }
110
- return envValue;
111
- };
112
- exports.readEnvOrError = readEnvOrError;
113
- const requireValue = (value, description) => {
114
- if (value === undefined) {
115
- throw new Error(`Missing required value: ${description}`);
116
- }
117
- return value;
118
- };
119
- exports.requireValue = requireValue;
120
143
  //# sourceMappingURL=server.js.map
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,15 +1,17 @@
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
- import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
3
+ import { CallToolRequestSchema, ListToolsRequestSchema, SetLevelRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
4
4
  import Roark from '@roarkanalytics/sdk';
5
5
  import { codeTool } from "./code-tool.mjs";
6
6
  import docsSearchTool from "./docs-search-tool.mjs";
7
- async function getInstructions() {
8
- // This API key is optional; providing it allows the server to fetch instructions for unreleased versions.
9
- const stainlessAPIKey = readEnv('STAINLESS_API_KEY');
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.
10
12
  const response = await fetch(readEnv('CODE_MODE_INSTRUCTIONS_URL') ?? 'https://api.stainless.com/api/ai/instructions/roark-analytics', {
11
13
  method: 'GET',
12
- headers: { ...(stainlessAPIKey && { Authorization: stainlessAPIKey }) },
14
+ headers: { ...(stainlessApiKey && { Authorization: stainlessApiKey }) },
13
15
  });
14
16
  let instructions;
15
17
  if (!response.ok) {
@@ -30,11 +32,11 @@ async function getInstructions() {
30
32
  `;
31
33
  return instructions;
32
34
  }
33
- export const newMcpServer = async () => new McpServer({
35
+ export const newMcpServer = async (stainlessApiKey) => new McpServer({
34
36
  name: 'roarkanalytics_sdk_api',
35
- version: '2.19.1',
37
+ version: '2.23.0',
36
38
  }, {
37
- instructions: await getInstructions(),
39
+ instructions: await getInstructions(stainlessApiKey),
38
40
  capabilities: { tools: {}, logging: {} },
39
41
  });
40
42
  /**
@@ -43,7 +45,20 @@ export const newMcpServer = async () => new McpServer({
43
45
  */
44
46
  export async function initMcpServer(params) {
45
47
  const server = params.server instanceof McpServer ? params.server.server : params.server;
46
- const client = new Roark({
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 Roark({
61
+ logger,
47
62
  ...params.clientOptions,
48
63
  defaultHeaders: {
49
64
  ...params.clientOptions?.defaultHeaders,
@@ -63,14 +78,47 @@ export async function initMcpServer(params) {
63
78
  if (!mcpTool) {
64
79
  throw new Error(`Unknown tool: ${name}`);
65
80
  }
66
- return executeHandler(mcpTool.handler, client, args);
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 {};
67
111
  });
68
112
  }
69
113
  /**
70
114
  * Selects the tools to include in the MCP Server based on the provided options.
71
115
  */
72
116
  export function selectTools(options) {
73
- const includedTools = [codeTool()];
117
+ const includedTools = [
118
+ codeTool({
119
+ blockedMethods: blockedMethodsForCodeTool(options),
120
+ }),
121
+ ];
74
122
  if (options?.includeDocsTools ?? true) {
75
123
  includedTools.push(docsSearchTool);
76
124
  }
@@ -79,29 +127,7 @@ export function selectTools(options) {
79
127
  /**
80
128
  * Runs the provided handler with the given client and arguments.
81
129
  */
82
- export async function executeHandler(handler, client, args) {
83
- return await handler(client, args || {});
130
+ export async function executeHandler({ handler, reqContext, args, }) {
131
+ return await handler({ reqContext, args: args || {} });
84
132
  }
85
- export const readEnv = (env) => {
86
- if (typeof globalThis.process !== 'undefined') {
87
- return globalThis.process.env?.[env]?.trim();
88
- }
89
- else if (typeof globalThis.Deno !== 'undefined') {
90
- return globalThis.Deno.env?.get?.(env)?.trim();
91
- }
92
- return;
93
- };
94
- export const readEnvOrError = (env) => {
95
- let envValue = readEnv(env);
96
- if (envValue === undefined) {
97
- throw new Error(`Environment variable ${env} is not set`);
98
- }
99
- return envValue;
100
- };
101
- export const requireValue = (value, description) => {
102
- if (value === undefined) {
103
- throw new Error(`Missing required value: ${description}`);
104
- }
105
- return value;
106
- };
107
133
  //# sourceMappingURL=server.mjs.map
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":"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"}
@@ -2,8 +2,9 @@
2
2
 
3
3
  import { IncomingMessage } from 'node:http';
4
4
  import { ClientOptions } from '@roarkanalytics/sdk';
5
+ import { McpOptions } from './options';
5
6
 
6
- export const parseAuthHeaders = (req: IncomingMessage, required?: boolean): Partial<ClientOptions> => {
7
+ export const parseClientAuthHeaders = (req: IncomingMessage, required?: boolean): Partial<ClientOptions> => {
7
8
  if (req.headers.authorization) {
8
9
  const scheme = req.headers.authorization.split(' ')[0]!;
9
10
  const value = req.headers.authorization.slice(scheme.length + 1);
@@ -25,3 +26,17 @@ export const parseAuthHeaders = (req: IncomingMessage, required?: boolean): Part
25
26
  : req.headers['x-roark-api-bearer-token'];
26
27
  return { bearerToken };
27
28
  };
29
+
30
+ export const getStainlessApiKey = (req: IncomingMessage, mcpOptions: McpOptions): string | undefined => {
31
+ // Try to get the key from the x-stainless-api-key header
32
+ const headerKey =
33
+ Array.isArray(req.headers['x-stainless-api-key']) ?
34
+ req.headers['x-stainless-api-key'][0]
35
+ : req.headers['x-stainless-api-key'];
36
+ if (headerKey && typeof headerKey === 'string') {
37
+ return headerKey;
38
+ }
39
+
40
+ // Fall back to value set in the mcpOptions (e.g. from environment variable), if provided
41
+ return mcpOptions.stainlessApiKey;
42
+ };