@letoribo/mcp-graphql-enhanced 2.1.7 → 2.1.9
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.
- package/dist/index.d.ts +1 -16
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +122 -29
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -1,18 +1,3 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
declare const StdioServerTransport: any;
|
|
4
|
-
declare const parse: any;
|
|
5
|
-
declare const z: any;
|
|
6
|
-
declare const checkDeprecatedArguments: any;
|
|
7
|
-
declare const introspectEndpoint: any, introspectLocalSchema: any, introspectSchemaFromUrl: any, introspectTypes: any;
|
|
8
|
-
declare const getVersion: () => any;
|
|
9
|
-
declare const EnvSchema: any;
|
|
10
|
-
declare const env: any;
|
|
11
|
-
declare const server: any;
|
|
12
|
-
interface IntrospectSchemaArgs {
|
|
13
|
-
typeNames?: string[];
|
|
14
|
-
descriptions?: boolean;
|
|
15
|
-
directives?: boolean;
|
|
16
|
-
}
|
|
17
|
-
declare function main(): Promise<void>;
|
|
2
|
+
export {};
|
|
18
3
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
|
package/dist/index.js
CHANGED
|
@@ -1,18 +1,17 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
"use strict";
|
|
3
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
+
const http = require("node:http");
|
|
3
5
|
const { McpServer } = require("@modelcontextprotocol/sdk/server/mcp.js");
|
|
4
6
|
const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
|
|
5
7
|
const { parse } = require("graphql/language");
|
|
6
8
|
const z = require("zod").default;
|
|
7
|
-
const { checkDeprecatedArguments } = require("./helpers/deprecation
|
|
8
|
-
const { introspectEndpoint, introspectLocalSchema, introspectSchemaFromUrl, introspectTypes, } = require("./helpers/introspection
|
|
9
|
-
// Simulate macro import — since "with { type: 'macro' }" is not CommonJS compatible
|
|
9
|
+
const { checkDeprecatedArguments } = require("./helpers/deprecation");
|
|
10
|
+
const { introspectEndpoint, introspectLocalSchema, introspectSchemaFromUrl, introspectTypes, } = require("./helpers/introspection");
|
|
10
11
|
const getVersion = () => {
|
|
11
|
-
// Replace with your actual version or read from package.json
|
|
12
12
|
const pkg = require("../package.json");
|
|
13
13
|
return pkg.version;
|
|
14
14
|
};
|
|
15
|
-
// Check for deprecated command line arguments
|
|
16
15
|
checkDeprecatedArguments();
|
|
17
16
|
const EnvSchema = z.object({
|
|
18
17
|
NAME: z.string().default("mcp-graphql-enhanced"),
|
|
@@ -33,6 +32,7 @@ const EnvSchema = z.object({
|
|
|
33
32
|
}
|
|
34
33
|
}),
|
|
35
34
|
SCHEMA: z.string().optional(),
|
|
35
|
+
MCP_PORT: z.preprocess((val) => (val ? parseInt(val) : 6274), z.number().int().min(1024).max(65535)).default(6274),
|
|
36
36
|
});
|
|
37
37
|
const env = EnvSchema.parse(process.env);
|
|
38
38
|
const server = new McpServer({
|
|
@@ -68,21 +68,14 @@ server.resource("graphql-schema", new URL(env.ENDPOINT).href, async (uri) => {
|
|
|
68
68
|
throw new Error(`Failed to get GraphQL schema: ${error}`);
|
|
69
69
|
}
|
|
70
70
|
});
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
endpoint: z.string().optional(),
|
|
74
|
-
headers: z.string().optional(),
|
|
75
|
-
descriptions: z.boolean().optional().default(true),
|
|
76
|
-
directives: z.boolean().optional().default(true),
|
|
77
|
-
}, async ({ typeNames, descriptions = true, directives = true }) => {
|
|
71
|
+
const toolHandlers = new Map();
|
|
72
|
+
const introspectSchemaHandler = async ({ typeNames, descriptions = true, directives = true }) => {
|
|
78
73
|
try {
|
|
79
74
|
if (typeNames && typeNames.length > 0) {
|
|
80
|
-
// ✅ Use your existing introspectTypes helper
|
|
81
75
|
const filtered = await introspectTypes(env.ENDPOINT, env.HEADERS, typeNames);
|
|
82
76
|
return { content: [{ type: "text", text: filtered }] };
|
|
83
77
|
}
|
|
84
78
|
else {
|
|
85
|
-
// Fallback to full schema
|
|
86
79
|
let schema;
|
|
87
80
|
if (env.SCHEMA) {
|
|
88
81
|
if (env.SCHEMA.startsWith("http://") || env.SCHEMA.startsWith("https://")) {
|
|
@@ -104,15 +97,14 @@ server.tool("introspect-schema", "Introspect the GraphQL schema. Optionally filt
|
|
|
104
97
|
content: [{ type: "text", text: `Introspection failed: ${error}` }],
|
|
105
98
|
};
|
|
106
99
|
}
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
}, async ({ query, variables, headers }) => {
|
|
100
|
+
};
|
|
101
|
+
toolHandlers.set("introspect-schema", introspectSchemaHandler);
|
|
102
|
+
server.tool("introspect-schema", "Introspect the GraphQL schema. Optionally filter to specific types.", {
|
|
103
|
+
typeNames: z.array(z.string()).optional().describe("e.g., [\"Query\", \"User\"]"),
|
|
104
|
+
descriptions: z.boolean().optional().default(true),
|
|
105
|
+
directives: z.boolean().optional().default(true),
|
|
106
|
+
}, introspectSchemaHandler);
|
|
107
|
+
const queryGraphqlHandler = async ({ query, variables, headers }) => {
|
|
116
108
|
try {
|
|
117
109
|
const parsedQuery = parse(query);
|
|
118
110
|
const isMutation = parsedQuery.definitions.some((def) => def.kind === "OperationDefinition" && def.operation === "mutation");
|
|
@@ -148,7 +140,6 @@ server.tool("query-graphql", "Query a GraphQL endpoint with the given query and
|
|
|
148
140
|
...env.HEADERS,
|
|
149
141
|
...toolHeaders,
|
|
150
142
|
};
|
|
151
|
-
// Parse variables if it's a string
|
|
152
143
|
let parsedVariables = null;
|
|
153
144
|
if (variables) {
|
|
154
145
|
if (typeof variables === 'string') {
|
|
@@ -179,7 +170,6 @@ server.tool("query-graphql", "Query a GraphQL endpoint with the given query and
|
|
|
179
170
|
};
|
|
180
171
|
}
|
|
181
172
|
const rawData = await response.json();
|
|
182
|
-
// Type assertion for quick dev (replace with zod validation later)
|
|
183
173
|
const data = rawData;
|
|
184
174
|
if (data.errors && data.errors.length > 0) {
|
|
185
175
|
return {
|
|
@@ -212,11 +202,114 @@ server.tool("query-graphql", "Query a GraphQL endpoint with the given query and
|
|
|
212
202
|
],
|
|
213
203
|
};
|
|
214
204
|
}
|
|
215
|
-
}
|
|
205
|
+
};
|
|
206
|
+
toolHandlers.set("query-graphql", queryGraphqlHandler);
|
|
207
|
+
server.tool("query-graphql", "Query a GraphQL endpoint with the given query and variables. Optionally pass headers (e.g., for Authorization).", {
|
|
208
|
+
query: z.string(),
|
|
209
|
+
variables: z.string().optional(),
|
|
210
|
+
headers: z
|
|
211
|
+
.string()
|
|
212
|
+
.optional()
|
|
213
|
+
.describe("Optional JSON string of headers to include, e.g., {\"Authorization\": \"Bearer ...\"}"),
|
|
214
|
+
}, queryGraphqlHandler);
|
|
215
|
+
function readBody(req) {
|
|
216
|
+
return new Promise((resolve, reject) => {
|
|
217
|
+
let body = '';
|
|
218
|
+
req.on('data', (chunk) => {
|
|
219
|
+
body += chunk.toString();
|
|
220
|
+
});
|
|
221
|
+
req.on('end', () => {
|
|
222
|
+
resolve(body);
|
|
223
|
+
});
|
|
224
|
+
req.on('error', reject);
|
|
225
|
+
});
|
|
226
|
+
}
|
|
227
|
+
async function handleHttpRequest(req, res) {
|
|
228
|
+
res.setHeader('Access-Control-Allow-Origin', '*');
|
|
229
|
+
res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
|
|
230
|
+
res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
|
|
231
|
+
if (req.method === 'OPTIONS') {
|
|
232
|
+
res.writeHead(204);
|
|
233
|
+
res.end();
|
|
234
|
+
return;
|
|
235
|
+
}
|
|
236
|
+
const url = new URL(req.url, `http://${req.headers.host}`);
|
|
237
|
+
if (url.pathname === '/health' && req.method === 'GET') {
|
|
238
|
+
res.writeHead(200, { 'Content-Type': 'application/json' });
|
|
239
|
+
res.end(JSON.stringify({ status: 'ok', server: env.NAME }));
|
|
240
|
+
return;
|
|
241
|
+
}
|
|
242
|
+
if (url.pathname === '/mcp' && req.method === 'POST') {
|
|
243
|
+
let rawBody;
|
|
244
|
+
let request;
|
|
245
|
+
try {
|
|
246
|
+
rawBody = await readBody(req);
|
|
247
|
+
request = JSON.parse(rawBody);
|
|
248
|
+
}
|
|
249
|
+
catch (e) {
|
|
250
|
+
console.error("HTTP MCP Parse Error:", e);
|
|
251
|
+
res.writeHead(400, { 'Content-Type': 'application/json' });
|
|
252
|
+
res.end(JSON.stringify({
|
|
253
|
+
jsonrpc: '2.0',
|
|
254
|
+
id: null,
|
|
255
|
+
error: { code: -32700, message: 'Parse Error: Invalid JSON received in request body.' }
|
|
256
|
+
}));
|
|
257
|
+
return;
|
|
258
|
+
}
|
|
259
|
+
try {
|
|
260
|
+
const { method, params, id } = request;
|
|
261
|
+
if (!method || typeof id === 'undefined') {
|
|
262
|
+
res.writeHead(400, { 'Content-Type': 'application/json' });
|
|
263
|
+
res.end(JSON.stringify({
|
|
264
|
+
jsonrpc: '2.0',
|
|
265
|
+
id: id || null,
|
|
266
|
+
error: { code: -32600, message: 'Invalid JSON-RPC Request structure (missing method or id).' }
|
|
267
|
+
}));
|
|
268
|
+
return;
|
|
269
|
+
}
|
|
270
|
+
const handler = toolHandlers.get(method);
|
|
271
|
+
if (!handler) {
|
|
272
|
+
res.writeHead(404, { 'Content-Type': 'application/json' });
|
|
273
|
+
res.end(JSON.stringify({
|
|
274
|
+
jsonrpc: '2.0',
|
|
275
|
+
id: id,
|
|
276
|
+
error: { code: -32601, message: `Method not found: ${method}` }
|
|
277
|
+
}));
|
|
278
|
+
return;
|
|
279
|
+
}
|
|
280
|
+
const result = await handler(params);
|
|
281
|
+
res.writeHead(200, { 'Content-Type': 'application/json' });
|
|
282
|
+
res.end(JSON.stringify({
|
|
283
|
+
jsonrpc: '2.0',
|
|
284
|
+
id: id,
|
|
285
|
+
result: result
|
|
286
|
+
}));
|
|
287
|
+
}
|
|
288
|
+
catch (error) {
|
|
289
|
+
console.error("HTTP MCP Execution Error:", error);
|
|
290
|
+
res.writeHead(500, { 'Content-Type': 'application/json' });
|
|
291
|
+
res.end(JSON.stringify({
|
|
292
|
+
jsonrpc: '2.0',
|
|
293
|
+
id: request?.id || null,
|
|
294
|
+
error: { code: -32603, message: 'Internal server error during tool execution.' }
|
|
295
|
+
}));
|
|
296
|
+
}
|
|
297
|
+
return;
|
|
298
|
+
}
|
|
299
|
+
res.writeHead(404, { 'Content-Type': 'text/plain' });
|
|
300
|
+
res.end('Not Found. Use POST /mcp for JSON-RPC or GET /health.');
|
|
301
|
+
}
|
|
302
|
+
function startHttpTransport() {
|
|
303
|
+
const server = http.createServer(handleHttpRequest);
|
|
304
|
+
server.listen(env.MCP_PORT, () => {
|
|
305
|
+
console.error(`[HTTP] Started server on http://localhost:${env.MCP_PORT}. Listening for POST /mcp requests.`);
|
|
306
|
+
});
|
|
307
|
+
}
|
|
216
308
|
async function main() {
|
|
217
|
-
const
|
|
218
|
-
await server.connect(
|
|
219
|
-
|
|
309
|
+
const stdioTransport = new StdioServerTransport();
|
|
310
|
+
await server.connect(stdioTransport);
|
|
311
|
+
startHttpTransport();
|
|
312
|
+
console.error(`[STDIO] Started graphql mcp server ${env.NAME} for endpoint: ${env.ENDPOINT}`);
|
|
220
313
|
}
|
|
221
314
|
main().catch((error) => {
|
|
222
315
|
console.error(`Fatal error in main(): ${error}`);
|
package/package.json
CHANGED