@seatable/mcp-seatable 0.9.5

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 (193) hide show
  1. package/.env.example +11 -0
  2. package/LICENSE +21 -0
  3. package/README.md +302 -0
  4. package/bin/seatable-mcp.cjs +20 -0
  5. package/dist/auth/tokenValidator.d.ts +10 -0
  6. package/dist/auth/tokenValidator.d.ts.map +1 -0
  7. package/dist/auth/tokenValidator.js +55 -0
  8. package/dist/auth/tokenValidator.js.map +1 -0
  9. package/dist/config/env.d.ts +67 -0
  10. package/dist/config/env.d.ts.map +1 -0
  11. package/dist/config/env.js +105 -0
  12. package/dist/config/env.js.map +1 -0
  13. package/dist/errors.d.ts +8 -0
  14. package/dist/errors.d.ts.map +1 -0
  15. package/dist/errors.js +28 -0
  16. package/dist/errors.js.map +1 -0
  17. package/dist/http/httpServer.d.ts +7 -0
  18. package/dist/http/httpServer.d.ts.map +1 -0
  19. package/dist/http/httpServer.js +211 -0
  20. package/dist/http/httpServer.js.map +1 -0
  21. package/dist/http/sseServer.d.ts +11 -0
  22. package/dist/http/sseServer.d.ts.map +1 -0
  23. package/dist/http/sseServer.js +154 -0
  24. package/dist/http/sseServer.js.map +1 -0
  25. package/dist/index.d.ts +13 -0
  26. package/dist/index.d.ts.map +1 -0
  27. package/dist/index.js +86 -0
  28. package/dist/index.js.map +1 -0
  29. package/dist/logger.d.ts +5 -0
  30. package/dist/logger.d.ts.map +1 -0
  31. package/dist/logger.js +34 -0
  32. package/dist/logger.js.map +1 -0
  33. package/dist/mcp/server.d.ts +52 -0
  34. package/dist/mcp/server.d.ts.map +1 -0
  35. package/dist/mcp/server.js +222 -0
  36. package/dist/mcp/server.js.map +1 -0
  37. package/dist/mcp/tools/addRow.d.ts +3 -0
  38. package/dist/mcp/tools/addRow.d.ts.map +1 -0
  39. package/dist/mcp/tools/addRow.js +23 -0
  40. package/dist/mcp/tools/addRow.js.map +1 -0
  41. package/dist/mcp/tools/addSelectOption.d.ts +3 -0
  42. package/dist/mcp/tools/addSelectOption.d.ts.map +1 -0
  43. package/dist/mcp/tools/addSelectOption.js +27 -0
  44. package/dist/mcp/tools/addSelectOption.js.map +1 -0
  45. package/dist/mcp/tools/appendRows.d.ts +3 -0
  46. package/dist/mcp/tools/appendRows.d.ts.map +1 -0
  47. package/dist/mcp/tools/appendRows.js +27 -0
  48. package/dist/mcp/tools/appendRows.js.map +1 -0
  49. package/dist/mcp/tools/attachFileToRow.d.ts +3 -0
  50. package/dist/mcp/tools/attachFileToRow.d.ts.map +1 -0
  51. package/dist/mcp/tools/attachFileToRow.js +42 -0
  52. package/dist/mcp/tools/attachFileToRow.js.map +1 -0
  53. package/dist/mcp/tools/bulkSetSelectOptions.d.ts +3 -0
  54. package/dist/mcp/tools/bulkSetSelectOptions.d.ts.map +1 -0
  55. package/dist/mcp/tools/bulkSetSelectOptions.js +49 -0
  56. package/dist/mcp/tools/bulkSetSelectOptions.js.map +1 -0
  57. package/dist/mcp/tools/deleteRow.d.ts +3 -0
  58. package/dist/mcp/tools/deleteRow.d.ts.map +1 -0
  59. package/dist/mcp/tools/deleteRow.js +22 -0
  60. package/dist/mcp/tools/deleteRow.js.map +1 -0
  61. package/dist/mcp/tools/echoArgs.d.ts +3 -0
  62. package/dist/mcp/tools/echoArgs.d.ts.map +1 -0
  63. package/dist/mcp/tools/echoArgs.js +14 -0
  64. package/dist/mcp/tools/echoArgs.js.map +1 -0
  65. package/dist/mcp/tools/findRows.d.ts +9 -0
  66. package/dist/mcp/tools/findRows.d.ts.map +1 -0
  67. package/dist/mcp/tools/findRows.js +255 -0
  68. package/dist/mcp/tools/findRows.js.map +1 -0
  69. package/dist/mcp/tools/getRow.d.ts +3 -0
  70. package/dist/mcp/tools/getRow.d.ts.map +1 -0
  71. package/dist/mcp/tools/getRow.js +18 -0
  72. package/dist/mcp/tools/getRow.js.map +1 -0
  73. package/dist/mcp/tools/getSchema.d.ts +3 -0
  74. package/dist/mcp/tools/getSchema.d.ts.map +1 -0
  75. package/dist/mcp/tools/getSchema.js +16 -0
  76. package/dist/mcp/tools/getSchema.js.map +1 -0
  77. package/dist/mcp/tools/linkRows.d.ts +3 -0
  78. package/dist/mcp/tools/linkRows.d.ts.map +1 -0
  79. package/dist/mcp/tools/linkRows.js +23 -0
  80. package/dist/mcp/tools/linkRows.js.map +1 -0
  81. package/dist/mcp/tools/listBases.d.ts +3 -0
  82. package/dist/mcp/tools/listBases.d.ts.map +1 -0
  83. package/dist/mcp/tools/listBases.js +16 -0
  84. package/dist/mcp/tools/listBases.js.map +1 -0
  85. package/dist/mcp/tools/listCollaborators.d.ts +3 -0
  86. package/dist/mcp/tools/listCollaborators.d.ts.map +1 -0
  87. package/dist/mcp/tools/listCollaborators.js +16 -0
  88. package/dist/mcp/tools/listCollaborators.js.map +1 -0
  89. package/dist/mcp/tools/listRows.d.ts +3 -0
  90. package/dist/mcp/tools/listRows.d.ts.map +1 -0
  91. package/dist/mcp/tools/listRows.js +20 -0
  92. package/dist/mcp/tools/listRows.js.map +1 -0
  93. package/dist/mcp/tools/listTables.d.ts +3 -0
  94. package/dist/mcp/tools/listTables.d.ts.map +1 -0
  95. package/dist/mcp/tools/listTables.js +19 -0
  96. package/dist/mcp/tools/listTables.js.map +1 -0
  97. package/dist/mcp/tools/manageColumns.d.ts +3 -0
  98. package/dist/mcp/tools/manageColumns.d.ts.map +1 -0
  99. package/dist/mcp/tools/manageColumns.js +44 -0
  100. package/dist/mcp/tools/manageColumns.js.map +1 -0
  101. package/dist/mcp/tools/manageTables.d.ts +3 -0
  102. package/dist/mcp/tools/manageTables.d.ts.map +1 -0
  103. package/dist/mcp/tools/manageTables.js +36 -0
  104. package/dist/mcp/tools/manageTables.js.map +1 -0
  105. package/dist/mcp/tools/pingSeatable.d.ts +3 -0
  106. package/dist/mcp/tools/pingSeatable.d.ts.map +1 -0
  107. package/dist/mcp/tools/pingSeatable.js +37 -0
  108. package/dist/mcp/tools/pingSeatable.js.map +1 -0
  109. package/dist/mcp/tools/querySql.d.ts +3 -0
  110. package/dist/mcp/tools/querySql.d.ts.map +1 -0
  111. package/dist/mcp/tools/querySql.js +28 -0
  112. package/dist/mcp/tools/querySql.js.map +1 -0
  113. package/dist/mcp/tools/searchRows.d.ts +3 -0
  114. package/dist/mcp/tools/searchRows.d.ts.map +1 -0
  115. package/dist/mcp/tools/searchRows.js +18 -0
  116. package/dist/mcp/tools/searchRows.js.map +1 -0
  117. package/dist/mcp/tools/types.d.ts +90 -0
  118. package/dist/mcp/tools/types.d.ts.map +1 -0
  119. package/dist/mcp/tools/types.js +2 -0
  120. package/dist/mcp/tools/types.js.map +1 -0
  121. package/dist/mcp/tools/unlinkRows.d.ts +3 -0
  122. package/dist/mcp/tools/unlinkRows.d.ts.map +1 -0
  123. package/dist/mcp/tools/unlinkRows.js +23 -0
  124. package/dist/mcp/tools/unlinkRows.js.map +1 -0
  125. package/dist/mcp/tools/updateRow.d.ts +3 -0
  126. package/dist/mcp/tools/updateRow.d.ts.map +1 -0
  127. package/dist/mcp/tools/updateRow.js +32 -0
  128. package/dist/mcp/tools/updateRow.js.map +1 -0
  129. package/dist/mcp/tools/uploadFile.d.ts +3 -0
  130. package/dist/mcp/tools/uploadFile.d.ts.map +1 -0
  131. package/dist/mcp/tools/uploadFile.js +29 -0
  132. package/dist/mcp/tools/uploadFile.js.map +1 -0
  133. package/dist/mcp/tools/upsertRows.d.ts +3 -0
  134. package/dist/mcp/tools/upsertRows.d.ts.map +1 -0
  135. package/dist/mcp/tools/upsertRows.js +55 -0
  136. package/dist/mcp/tools/upsertRows.js.map +1 -0
  137. package/dist/ratelimit/connectionCounter.d.ts +11 -0
  138. package/dist/ratelimit/connectionCounter.d.ts.map +1 -0
  139. package/dist/ratelimit/connectionCounter.js +27 -0
  140. package/dist/ratelimit/connectionCounter.js.map +1 -0
  141. package/dist/ratelimit/index.d.ts +27 -0
  142. package/dist/ratelimit/index.d.ts.map +1 -0
  143. package/dist/ratelimit/index.js +50 -0
  144. package/dist/ratelimit/index.js.map +1 -0
  145. package/dist/ratelimit/rateLimiter.d.ts +18 -0
  146. package/dist/ratelimit/rateLimiter.d.ts.map +1 -0
  147. package/dist/ratelimit/rateLimiter.js +54 -0
  148. package/dist/ratelimit/rateLimiter.js.map +1 -0
  149. package/dist/schema/generic.d.ts +126 -0
  150. package/dist/schema/generic.d.ts.map +1 -0
  151. package/dist/schema/generic.js +45 -0
  152. package/dist/schema/generic.js.map +1 -0
  153. package/dist/schema/jsonSchemaToZod.d.ts +3 -0
  154. package/dist/schema/jsonSchemaToZod.d.ts.map +1 -0
  155. package/dist/schema/jsonSchemaToZod.js +53 -0
  156. package/dist/schema/jsonSchemaToZod.js.map +1 -0
  157. package/dist/schema/map.d.ts +3 -0
  158. package/dist/schema/map.d.ts.map +1 -0
  159. package/dist/schema/map.js +92 -0
  160. package/dist/schema/map.js.map +1 -0
  161. package/dist/schema/validate.d.ts +15 -0
  162. package/dist/schema/validate.d.ts.map +1 -0
  163. package/dist/schema/validate.js +170 -0
  164. package/dist/schema/validate.js.map +1 -0
  165. package/dist/seatable/client.d.ts +106 -0
  166. package/dist/seatable/client.d.ts.map +1 -0
  167. package/dist/seatable/client.js +378 -0
  168. package/dist/seatable/client.js.map +1 -0
  169. package/dist/seatable/clientRegistry.d.ts +11 -0
  170. package/dist/seatable/clientRegistry.d.ts.map +1 -0
  171. package/dist/seatable/clientRegistry.js +33 -0
  172. package/dist/seatable/clientRegistry.js.map +1 -0
  173. package/dist/seatable/contextualClient.d.ts +92 -0
  174. package/dist/seatable/contextualClient.d.ts.map +1 -0
  175. package/dist/seatable/contextualClient.js +42 -0
  176. package/dist/seatable/contextualClient.js.map +1 -0
  177. package/dist/seatable/mockClient.d.ts +68 -0
  178. package/dist/seatable/mockClient.d.ts.map +1 -0
  179. package/dist/seatable/mockClient.js +115 -0
  180. package/dist/seatable/mockClient.js.map +1 -0
  181. package/dist/seatable/tokenManager.d.ts +28 -0
  182. package/dist/seatable/tokenManager.d.ts.map +1 -0
  183. package/dist/seatable/tokenManager.js +92 -0
  184. package/dist/seatable/tokenManager.js.map +1 -0
  185. package/dist/seatable/types.d.ts +22 -0
  186. package/dist/seatable/types.d.ts.map +1 -0
  187. package/dist/seatable/types.js +3 -0
  188. package/dist/seatable/types.js.map +1 -0
  189. package/dist/seatable/utils.d.ts +7 -0
  190. package/dist/seatable/utils.d.ts.map +1 -0
  191. package/dist/seatable/utils.js +25 -0
  192. package/dist/seatable/utils.js.map +1 -0
  193. package/package.json +94 -0
@@ -0,0 +1,7 @@
1
+ import { type IncomingMessage, type ServerResponse } from 'node:http';
2
+ export interface StartHttpServerOptions {
3
+ host?: string;
4
+ port?: number;
5
+ }
6
+ export declare function startHttpServer(options?: StartHttpServerOptions): Promise<import("http").Server<typeof IncomingMessage, typeof ServerResponse>>;
7
+ //# sourceMappingURL=httpServer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"httpServer.d.ts","sourceRoot":"","sources":["../../src/http/httpServer.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AAUnF,MAAM,WAAW,sBAAsB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB;AA8BD,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,iFAwMzE"}
@@ -0,0 +1,211 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { createServer } from 'node:http';
3
+ import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
4
+ import { TokenValidator } from '../auth/tokenValidator.js';
5
+ import { getEnv, VERSION } from '../config/env.js';
6
+ import { logger } from '../logger.js';
7
+ import { buildServer, getStaticToolDefinitions } from '../mcp/server.js';
8
+ import { RateLimitManager } from '../ratelimit/index.js';
9
+ async function parseJsonBody(req) {
10
+ return await new Promise((resolve, reject) => {
11
+ const chunks = [];
12
+ req.on('data', (chunk) => {
13
+ chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
14
+ });
15
+ req.on('end', () => {
16
+ if (!chunks.length) {
17
+ resolve(undefined);
18
+ return;
19
+ }
20
+ try {
21
+ const data = Buffer.concat(chunks).toString('utf-8');
22
+ resolve(JSON.parse(data));
23
+ }
24
+ catch (error) {
25
+ reject(error);
26
+ }
27
+ });
28
+ req.on('error', reject);
29
+ });
30
+ }
31
+ export async function startHttpServer(options = {}) {
32
+ const host = options.host ?? process.env.HOST ?? '0.0.0.0';
33
+ const port = options.port ?? Number(process.env.PORT ?? 3000);
34
+ const env = getEnv();
35
+ const mode = env.SEATABLE_MODE;
36
+ const tokenValidator = mode === 'managed' ? new TokenValidator(env.SEATABLE_SERVER_URL) : undefined;
37
+ const rateLimiter = mode === 'managed' ? new RateLimitManager() : undefined;
38
+ const toolDefinitions = getStaticToolDefinitions();
39
+ const sessions = new Map();
40
+ function extractBearerToken(req) {
41
+ const auth = req.headers.authorization;
42
+ if (!auth)
43
+ return undefined;
44
+ return auth.startsWith('Bearer ') ? auth.slice(7) : auth;
45
+ }
46
+ function getClientIp(req) {
47
+ const forwarded = req.headers['x-forwarded-for'];
48
+ if (typeof forwarded === 'string')
49
+ return forwarded.split(',')[0].trim();
50
+ return req.socket.remoteAddress ?? 'unknown';
51
+ }
52
+ async function handleMcpRequest(req, res) {
53
+ // Rate limiting (managed mode only)
54
+ if (rateLimiter) {
55
+ const ip = getClientIp(req);
56
+ const sessionId_ = req.headers['mcp-session-id'];
57
+ const token = sessionId_ ? sessions.get(sessionId_)?.apiToken : undefined;
58
+ const result = rateLimiter.check({ ip, token });
59
+ if (!result.allowed) {
60
+ const retryAfter = Math.ceil(result.retryAfterMs / 1000);
61
+ res.writeHead(429, {
62
+ 'content-type': 'text/plain',
63
+ 'retry-after': String(retryAfter),
64
+ }).end(result.reason);
65
+ return;
66
+ }
67
+ }
68
+ // Parse body for POST requests
69
+ const body = req.method === 'POST' ? await parseJsonBody(req) : undefined;
70
+ // Extract session ID from header
71
+ const sessionId = req.headers['mcp-session-id'];
72
+ // For POST without session ID: this is an initialization request → new session
73
+ if (req.method === 'POST' && !sessionId) {
74
+ // In managed mode: require and validate Bearer token
75
+ let apiToken;
76
+ if (mode === 'managed') {
77
+ apiToken = extractBearerToken(req);
78
+ if (!apiToken) {
79
+ res.writeHead(401, { 'content-type': 'text/plain' }).end('Missing Authorization header');
80
+ return;
81
+ }
82
+ const valid = await tokenValidator.validate(apiToken);
83
+ if (!valid) {
84
+ res.writeHead(401, { 'content-type': 'text/plain' }).end('Invalid API token');
85
+ return;
86
+ }
87
+ }
88
+ // Connection limit (managed mode)
89
+ if (rateLimiter && apiToken) {
90
+ if (!rateLimiter.connections.acquire(apiToken)) {
91
+ res.writeHead(429, { 'content-type': 'text/plain' }).end('Too many concurrent connections');
92
+ return;
93
+ }
94
+ }
95
+ const mcpServer = buildServer(apiToken ? { apiToken } : undefined);
96
+ const transport = new StreamableHTTPServerTransport({
97
+ sessionIdGenerator: () => randomUUID(),
98
+ onsessioninitialized: (id) => {
99
+ logger.info({ sessionId: id }, 'Streamable HTTP session initialized');
100
+ sessions.set(id, { transport, apiToken, close: cleanup });
101
+ },
102
+ });
103
+ let cleaned = false;
104
+ const cleanup = async () => {
105
+ if (cleaned)
106
+ return;
107
+ cleaned = true;
108
+ if (apiToken && rateLimiter) {
109
+ rateLimiter.connections.release(apiToken);
110
+ }
111
+ if (transport.sessionId) {
112
+ sessions.delete(transport.sessionId);
113
+ }
114
+ try {
115
+ await transport.close();
116
+ }
117
+ catch (error) {
118
+ logger.debug({ err: error }, 'Error closing transport');
119
+ }
120
+ try {
121
+ await mcpServer.close();
122
+ }
123
+ catch (error) {
124
+ logger.debug({ err: error }, 'Error closing MCP server');
125
+ }
126
+ };
127
+ transport.onclose = () => {
128
+ void cleanup();
129
+ };
130
+ await mcpServer.connect(transport);
131
+ await transport.handleRequest(req, res, body);
132
+ return;
133
+ }
134
+ // For requests with an existing session ID: look up the session
135
+ if (sessionId) {
136
+ const session = sessions.get(sessionId);
137
+ if (!session) {
138
+ res.writeHead(404, { 'content-type': 'text/plain' }).end('Session expired. Please reconnect to start a new session.');
139
+ return;
140
+ }
141
+ await session.transport.handleRequest(req, res, body);
142
+ return;
143
+ }
144
+ // GET/DELETE without session ID
145
+ res.writeHead(400, { 'content-type': 'text/plain' }).end('Missing mcp-session-id header');
146
+ }
147
+ const server = createServer(async (req, res) => {
148
+ if (!req.url) {
149
+ res.writeHead(400, { 'content-type': 'text/plain' }).end('Missing request URL');
150
+ return;
151
+ }
152
+ const url = new URL(req.url, `http://${req.headers.host ?? 'localhost'}`);
153
+ if (url.pathname === '/mcp' && (req.method === 'POST' || req.method === 'GET' || req.method === 'DELETE')) {
154
+ try {
155
+ await handleMcpRequest(req, res);
156
+ }
157
+ catch (error) {
158
+ logger.error({ err: error }, 'Error handling MCP request');
159
+ if (!res.headersSent) {
160
+ res.writeHead(500, { 'content-type': 'text/plain' }).end('Internal server error');
161
+ }
162
+ }
163
+ return;
164
+ }
165
+ if (req.method === 'GET' && url.pathname === '/health') {
166
+ res.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify({ status: 'ok', version: VERSION }));
167
+ return;
168
+ }
169
+ if (req.method === 'GET' && url.pathname === '/') {
170
+ res.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify({ name: 'seatable-mcp', version: VERSION, docs: 'https://github.com/seatable/seatable-mcp' }));
171
+ return;
172
+ }
173
+ if (req.method === 'GET' && url.pathname === '/.well-known/mcp/server-card.json') {
174
+ const card = {
175
+ serverInfo: { name: '@seatable/mcp-seatable', version: VERSION },
176
+ authentication: { required: true, schemes: ['bearer'] },
177
+ capabilities: { tools: true, resources: false, prompts: false },
178
+ tools: toolDefinitions,
179
+ };
180
+ res.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify(card));
181
+ return;
182
+ }
183
+ res.writeHead(404, { 'content-type': 'application/json' }).end(JSON.stringify({ error: 'Not found' }));
184
+ });
185
+ await new Promise((resolve, reject) => {
186
+ server.once('listening', () => resolve());
187
+ server.once('error', (error) => reject(error));
188
+ server.listen(port, host);
189
+ });
190
+ logger.info({ host, port, endpoint: '/mcp' }, 'Streamable HTTP server listening');
191
+ const shutdown = async () => {
192
+ tokenValidator?.destroy();
193
+ rateLimiter?.destroy();
194
+ for (const [sessionId, session] of sessions.entries()) {
195
+ logger.debug({ sessionId }, 'Closing session during shutdown');
196
+ await session.close();
197
+ }
198
+ await new Promise((resolve) => server.close(() => resolve()));
199
+ };
200
+ const signals = ['SIGINT', 'SIGTERM'];
201
+ for (const signal of signals) {
202
+ process.once(signal, () => {
203
+ logger.info({ signal }, 'Received shutdown signal');
204
+ shutdown().catch((error) => {
205
+ logger.error({ err: error }, 'Error during shutdown');
206
+ });
207
+ });
208
+ }
209
+ return server;
210
+ }
211
+ //# sourceMappingURL=httpServer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"httpServer.js","sourceRoot":"","sources":["../../src/http/httpServer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import { type IncomingMessage, type ServerResponse } from 'node:http';
2
+ import { type SSEServerTransportOptions } from '@modelcontextprotocol/sdk/server/sse.js';
3
+ export interface StartSseServerOptions {
4
+ host?: string;
5
+ port?: number;
6
+ ssePath?: string;
7
+ messagePath?: string;
8
+ transportOptions?: SSEServerTransportOptions;
9
+ }
10
+ export declare function startSseServer(options?: StartSseServerOptions): Promise<import("http").Server<typeof IncomingMessage, typeof ServerResponse>>;
11
+ //# sourceMappingURL=sseServer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sseServer.d.ts","sourceRoot":"","sources":["../../src/http/sseServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AAInF,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,yCAAyC,CAAA;AAK5G,MAAM,WAAW,qBAAqB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,yBAAyB,CAAA;CAC/C;AAmHD,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B,iFAiEvE"}
@@ -0,0 +1,154 @@
1
+ import { createServer } from 'node:http';
2
+ import { URL } from 'node:url';
3
+ import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
4
+ import { logger } from '../logger.js';
5
+ import { buildServer } from '../mcp/server.js';
6
+ async function parseJsonBody(req) {
7
+ return await new Promise((resolve, reject) => {
8
+ const chunks = [];
9
+ req.on('data', (chunk) => {
10
+ chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
11
+ });
12
+ req.on('end', () => {
13
+ if (!chunks.length) {
14
+ resolve(undefined);
15
+ return;
16
+ }
17
+ try {
18
+ const data = Buffer.concat(chunks).toString('utf-8');
19
+ resolve(JSON.parse(data));
20
+ }
21
+ catch (error) {
22
+ reject(error);
23
+ }
24
+ });
25
+ req.on('error', reject);
26
+ });
27
+ }
28
+ async function handleSseConnection(req, res, sessions, messagePath, transportOptions) {
29
+ const server = buildServer();
30
+ const transport = new SSEServerTransport(messagePath, res, transportOptions);
31
+ const sessionId = transport.sessionId;
32
+ let cleaned = false;
33
+ const cleanup = async () => {
34
+ if (cleaned)
35
+ return;
36
+ cleaned = true;
37
+ sessions.delete(sessionId);
38
+ try {
39
+ await transport.close();
40
+ }
41
+ catch (error) {
42
+ logger.debug({ err: error, sessionId }, 'Error closing SSE transport');
43
+ }
44
+ try {
45
+ await server.close();
46
+ }
47
+ catch (error) {
48
+ logger.debug({ err: error, sessionId }, 'Error closing MCP server for SSE session');
49
+ }
50
+ };
51
+ transport.onclose = cleanup;
52
+ transport.onerror = (error) => {
53
+ logger.error({ err: error, sessionId }, 'SSE transport error');
54
+ };
55
+ res.on('close', () => {
56
+ void cleanup();
57
+ });
58
+ sessions.set(sessionId, {
59
+ transport,
60
+ close: cleanup,
61
+ });
62
+ logger.info({ sessionId }, 'Accepted SSE connection');
63
+ try {
64
+ await server.connect(transport);
65
+ await cleanup();
66
+ logger.info({ sessionId }, 'SSE session closed');
67
+ }
68
+ catch (error) {
69
+ logger.error({ err: error, sessionId }, 'Failed to establish SSE connection');
70
+ await cleanup();
71
+ if (!res.headersSent) {
72
+ res.writeHead(500, { 'content-type': 'text/plain' }).end('Failed to establish SSE connection');
73
+ }
74
+ }
75
+ }
76
+ async function handlePostMessage(req, res, session) {
77
+ if (!session) {
78
+ res.writeHead(404, { 'content-type': 'text/plain' }).end('Session not found');
79
+ return;
80
+ }
81
+ let body;
82
+ try {
83
+ body = await parseJsonBody(req);
84
+ }
85
+ catch (error) {
86
+ res.writeHead(400, { 'content-type': 'text/plain' }).end('Invalid JSON payload');
87
+ logger.warn({ err: error }, 'Failed to parse SSE message payload');
88
+ return;
89
+ }
90
+ try {
91
+ await session.transport.handlePostMessage(req, res, body);
92
+ }
93
+ catch (error) {
94
+ logger.error({ err: error }, 'Error handling SSE message');
95
+ if (!res.headersSent) {
96
+ res.writeHead(500, { 'content-type': 'text/plain' }).end('Failed to handle message');
97
+ }
98
+ }
99
+ }
100
+ export async function startSseServer(options = {}) {
101
+ const host = options.host ?? process.env.HOST ?? '0.0.0.0';
102
+ const port = options.port ?? Number(process.env.PORT ?? 3000);
103
+ const ssePath = options.ssePath ?? '/mcp';
104
+ const messagePath = options.messagePath ?? '/messages';
105
+ const sessions = new Map();
106
+ const server = createServer(async (req, res) => {
107
+ if (!req.url) {
108
+ res.writeHead(400, { 'content-type': 'text/plain' }).end('Missing request URL');
109
+ return;
110
+ }
111
+ const url = new URL(req.url, `http://${req.headers.host ?? 'localhost'}`);
112
+ if (req.method === 'GET' && url.pathname === ssePath) {
113
+ await handleSseConnection(req, res, sessions, messagePath, options.transportOptions);
114
+ return;
115
+ }
116
+ if (req.method === 'POST' && url.pathname === messagePath) {
117
+ const sessionId = url.searchParams.get('sessionId') ?? undefined;
118
+ const session = sessionId ? sessions.get(sessionId) : undefined;
119
+ await handlePostMessage(req, res, session);
120
+ return;
121
+ }
122
+ if (req.method === 'GET' && url.pathname === '/health') {
123
+ res.writeHead(200, { 'content-type': 'text/plain' }).end('ok');
124
+ return;
125
+ }
126
+ res.writeHead(404, { 'content-type': 'text/plain' }).end('Not found');
127
+ });
128
+ await new Promise((resolve, reject) => {
129
+ server.once('listening', () => resolve());
130
+ server.once('error', (error) => reject(error));
131
+ server.listen(port, host);
132
+ });
133
+ logger.info({ host, port, ssePath, messagePath }, 'SSE server listening');
134
+ const shutdown = async () => {
135
+ for (const [sessionId, session] of sessions.entries()) {
136
+ logger.debug({ sessionId }, 'Closing SSE session during shutdown');
137
+ await session.close();
138
+ }
139
+ await new Promise((resolve) => server.close(() => resolve()));
140
+ };
141
+ if (typeof process !== 'undefined' && process.once) {
142
+ const signals = ['SIGINT', 'SIGTERM'];
143
+ for (const signal of signals) {
144
+ process.once(signal, () => {
145
+ logger.info({ signal }, 'Received shutdown signal for SSE server');
146
+ shutdown().catch((error) => {
147
+ logger.error({ err: error }, 'Error during SSE server shutdown');
148
+ });
149
+ });
150
+ }
151
+ }
152
+ return server;
153
+ }
154
+ //# sourceMappingURL=sseServer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sseServer.js","sourceRoot":"","sources":["../../src/http/sseServer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ export type { ServerMode } from './config/env.js';
2
+ export { startHttpServer } from './http/httpServer.js';
3
+ export { buildServer } from './mcp/server.js';
4
+ export type { SeaTableClientConfig } from './seatable/client.js';
5
+ export { createClientFromEnv, createClientFromToken, SeaTableClient } from './seatable/client.js';
6
+ export interface McpServerConfig {
7
+ serverUrl?: string;
8
+ apiToken?: string;
9
+ mock?: boolean;
10
+ }
11
+ export declare function createMcpServer(config?: McpServerConfig): Promise<import("./mcp/server.js").SeaTableMCPServer>;
12
+ export declare function runCli(): Promise<void>;
13
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAC,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAEhG,MAAM,WAAW,eAAe;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAsB,eAAe,CAAC,MAAM,CAAC,EAAE,eAAe,wDAiB7D;AA6CD,wBAAsB,MAAM,kBAE3B"}
package/dist/index.js ADDED
@@ -0,0 +1,86 @@
1
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
2
+ import { setEnvOverrides, VERSION } from './config/env.js';
3
+ import { startHttpServer } from './http/httpServer.js';
4
+ import { logger } from './logger.js';
5
+ import { buildServer } from './mcp/server.js';
6
+ export { startHttpServer } from './http/httpServer.js';
7
+ export { buildServer } from './mcp/server.js';
8
+ export { createClientFromEnv, createClientFromToken, SeaTableClient } from './seatable/client.js';
9
+ export async function createMcpServer(config) {
10
+ // Set environment variables if config is provided
11
+ if (config) {
12
+ const overrides = {};
13
+ if (config.serverUrl)
14
+ overrides.SEATABLE_SERVER_URL = config.serverUrl;
15
+ if (config.apiToken)
16
+ overrides.SEATABLE_API_TOKEN = config.apiToken;
17
+ if (config.mock !== undefined)
18
+ overrides.SEATABLE_MOCK = config.mock ? '1' : '0';
19
+ if (Object.keys(overrides).length > 0) {
20
+ setEnvOverrides(overrides);
21
+ if (typeof process !== 'undefined' && process.env) {
22
+ Object.assign(process.env, overrides);
23
+ }
24
+ }
25
+ }
26
+ return buildServer();
27
+ }
28
+ function resolveTransport(argv) {
29
+ const envTransport = (typeof process !== 'undefined' && process.env
30
+ ? process.env.MCP_SEATABLE_TRANSPORT ?? process.env.MCP_TRANSPORT
31
+ : undefined)
32
+ ?.toLowerCase();
33
+ // Accept 'sse' as alias for backward compatibility
34
+ if (envTransport === 'sse' || envTransport === 'http')
35
+ return 'http';
36
+ if (argv.includes('--sse') || argv.includes('--http'))
37
+ return 'http';
38
+ const transportArg = argv.find((arg) => arg.startsWith('--transport='));
39
+ if (transportArg) {
40
+ const value = transportArg.split('=')[1]?.toLowerCase();
41
+ if (value === 'sse' || value === 'http')
42
+ return 'http';
43
+ }
44
+ return 'stdio';
45
+ }
46
+ async function main() {
47
+ if (resolveTransport(process.argv.slice(2)) === 'http') {
48
+ await runHttpServerCli();
49
+ return;
50
+ }
51
+ const server = buildServer();
52
+ // Wrap transport to log outgoing JSON-RPC for debugging
53
+ const transport = new StdioServerTransport();
54
+ const origSend = transport.send.bind(transport);
55
+ transport.send = (msg) => {
56
+ try {
57
+ logger.debug({ direction: 'out', msg });
58
+ }
59
+ catch { }
60
+ return origSend(msg);
61
+ };
62
+ await server.connect(transport);
63
+ logger.info(`MCP SeaTable server v${VERSION} running (stdio)`);
64
+ }
65
+ // Exported CLI entry for bin launcher (used by npx)
66
+ export async function runCli() {
67
+ return main();
68
+ }
69
+ async function runHttpServerCli() {
70
+ const server = await startHttpServer();
71
+ logger.info(`MCP SeaTable server v${VERSION} running (Streamable HTTP)`);
72
+ await new Promise((resolve, reject) => {
73
+ server.on('close', resolve);
74
+ server.on('error', reject);
75
+ });
76
+ }
77
+ // Only run main if this file is being executed directly
78
+ if (import.meta.url === `file://${process.argv[1]}`) {
79
+ main().catch((err) => {
80
+ logger.error(err);
81
+ // Mirror to stderr for visibility in non-MCP contexts
82
+ console.error(err);
83
+ process.exit(1);
84
+ });
85
+ }
86
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAEhF,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG7C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAC,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAQhG,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAwB;IAC1D,kDAAkD;IAClD,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,SAAS,GAA2B,EAAE,CAAA;QAC5C,IAAI,MAAM,CAAC,SAAS;YAAE,SAAS,CAAC,mBAAmB,GAAG,MAAM,CAAC,SAAS,CAAA;QACtE,IAAI,MAAM,CAAC,QAAQ;YAAE,SAAS,CAAC,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAA;QACnE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,SAAS,CAAC,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QAEhF,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,eAAe,CAAC,SAAS,CAAC,CAAA;YAC1B,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;YACzC,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,WAAW,EAAE,CAAA;AACxB,CAAC;AAID,SAAS,gBAAgB,CAAC,IAAc;IACpC,MAAM,YAAY,GAAG,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG;QAC/D,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa;QACjE,CAAC,CAAC,SAAS,CAAC;QACZ,EAAE,WAAW,EAAE,CAAA;IAEnB,mDAAmD;IACnD,IAAI,YAAY,KAAK,KAAK,IAAI,YAAY,KAAK,MAAM;QAAE,OAAO,MAAM,CAAA;IAEpE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAA;IAEpE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAA;IACvE,IAAI,YAAY,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAA;QACvD,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,MAAM,CAAA;IAC1D,CAAC;IAED,OAAO,OAAO,CAAA;AAClB,CAAC;AAED,KAAK,UAAU,IAAI;IACf,IAAI,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QACrD,MAAM,gBAAgB,EAAE,CAAA;QACxB,OAAM;IACV,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,EAAE,CAAA;IAE5B,wDAAwD;IACxD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAC9C;IAAC,SAAiB,CAAC,IAAI,GAAG,CAAC,GAAQ,EAAE,EAAE;QACpC,IAAI,CAAC;YAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACxD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC,CAAA;IAED,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,kBAAkB,CAAC,CAAA;AAClE,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,MAAM;IACxB,OAAO,IAAI,EAAE,CAAA;AACjB,CAAC;AAED,KAAK,UAAU,gBAAgB;IAC3B,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAA;IACtC,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,4BAA4B,CAAC,CAAA;IACxE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC3B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;AACN,CAAC;AAED,wDAAwD;AACxD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAClD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACjB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACjB,sDAAsD;QACtD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC,CAAC,CAAA;AACN,CAAC"}
@@ -0,0 +1,5 @@
1
+ import type { Logger } from 'pino';
2
+ declare let logger: Logger;
3
+ export { logger };
4
+ export declare function withRequest<T extends Record<string, unknown>>(fields: T): Logger<never, boolean>;
5
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,QAAA,IAAI,MAAM,EAAE,MAAM,CAAA;AA8BlB,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,0BAEvE"}
package/dist/logger.js ADDED
@@ -0,0 +1,34 @@
1
+ let logger;
2
+ if (typeof process !== 'undefined' && process.versions?.node && !('WebSocketPair' in globalThis)) {
3
+ // Node.js environment: use pino without destination (v9 removed destination())
4
+ const pinoModule = await import('pino');
5
+ const pino = pinoModule.default;
6
+ logger = pino({
7
+ level: process.env.LOG_LEVEL || 'info',
8
+ base: undefined,
9
+ redact: ['req.headers.authorization', 'config.headers.Authorization'],
10
+ timestamp: pino?.stdTimeFunctions?.isoTime,
11
+ });
12
+ }
13
+ else {
14
+ const createFallbackLogger = () => {
15
+ const base = {
16
+ level: 'info',
17
+ fatal: (...args) => console.error(...args),
18
+ error: (...args) => console.error(...args),
19
+ warn: (...args) => console.warn(...args),
20
+ info: (...args) => console.log(...args),
21
+ debug: (...args) => console.debug(...args),
22
+ trace: (...args) => console.debug(...args),
23
+ silent: () => { },
24
+ };
25
+ base.child = () => base;
26
+ return base;
27
+ };
28
+ logger = createFallbackLogger();
29
+ }
30
+ export { logger };
31
+ export function withRequest(fields) {
32
+ return logger.child(fields);
33
+ }
34
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,IAAI,MAAc,CAAA;AAElB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,eAAe,IAAI,UAAU,CAAC,EAAE,CAAC;IAC/F,+EAA+E;IAC/E,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;IACvC,MAAM,IAAI,GAAQ,UAAU,CAAC,OAAO,CAAA;IACpC,MAAM,GAAG,IAAI,CAAC;QACV,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,CAAC,2BAA2B,EAAE,8BAA8B,CAAC;QACrE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO;KAC7C,CAAW,CAAA;AAChB,CAAC;KAAM,CAAC;IACJ,MAAM,oBAAoB,GAAG,GAAG,EAAE;QAC9B,MAAM,IAAI,GAAQ;YACd,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACnD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YAClD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;SACnB,CAAA;QACD,IAAI,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAA;QACvB,OAAO,IAAc,CAAA;IACzB,CAAC,CAAA;IACD,MAAM,GAAG,oBAAoB,EAAE,CAAA;AACnC,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB,MAAM,UAAU,WAAW,CAAoC,MAAS;IACpE,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC"}
@@ -0,0 +1,52 @@
1
+ import { type Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
2
+ import { type CallToolResult } from '@modelcontextprotocol/sdk/types.js';
3
+ import { ContextualClient } from '../seatable/contextualClient.js';
4
+ import type { ClientLike } from './tools/types.js';
5
+ interface RegisteredTool {
6
+ name: string;
7
+ description: string;
8
+ inputSchema: any;
9
+ annotations?: {
10
+ readOnlyHint?: boolean;
11
+ destructiveHint?: boolean;
12
+ idempotentHint?: boolean;
13
+ openWorldHint?: boolean;
14
+ };
15
+ handler: (args: unknown) => Promise<CallToolResult>;
16
+ }
17
+ export declare class SeaTableMCPServer {
18
+ private readonly server;
19
+ private readonly client;
20
+ private readonly contextualClient?;
21
+ private readonly baseNames?;
22
+ private readonly tools;
23
+ constructor(client: ClientLike, multiBase?: {
24
+ contextualClient: ContextualClient;
25
+ baseNames: string[];
26
+ });
27
+ getToolDefinitions(): Array<{
28
+ name: string;
29
+ description: string;
30
+ inputSchema: any;
31
+ annotations?: RegisteredTool['annotations'];
32
+ }>;
33
+ connect(transport: Transport): Promise<void>;
34
+ close(): Promise<void>;
35
+ private registerAllTools;
36
+ private initializeHandlers;
37
+ private handleListTools;
38
+ private handleCallTool;
39
+ }
40
+ export interface BuildServerOptions {
41
+ apiToken?: string;
42
+ }
43
+ export declare function buildServer(options?: BuildServerOptions): SeaTableMCPServer;
44
+ /** Return tool definitions without needing a real SeaTable client. */
45
+ export declare function getStaticToolDefinitions(): {
46
+ name: string;
47
+ description: string;
48
+ inputSchema: any;
49
+ annotations?: RegisteredTool["annotations"];
50
+ }[];
51
+ export {};
52
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,+CAA+C,CAAA;AAC9E,OAAO,EAEH,KAAK,cAAc,EAGtB,MAAM,oCAAoC,CAAA;AAQ3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAmBlE,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,kBAAkB,CAAA;AA2BhE,UAAU,cAAc;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,GAAG,CAAA;IAChB,WAAW,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACtH,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;CACtD;AAED,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAE9C,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE;QAAE,gBAAgB,EAAE,gBAAgB,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE;IAqBvG,kBAAkB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,GAAG,CAAC;QAAC,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAA;KAAE,CAAC;IAM3H,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,gBAAgB;IAkDxB,OAAO,CAAC,kBAAkB;YAKZ,eAAe;YA0Bf,cAAc;CA+B/B;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,qBAsCvD;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB;UA7KA,MAAM;iBAAe,MAAM;iBAAe,GAAG;kBAAgB,cAAc,CAAC,aAAa,CAAC;IA+KjI"}