@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 CHANGED
@@ -1,18 +1,3 @@
1
1
  #!/usr/bin/env node
2
- declare const McpServer: any;
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
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,QAAA,MAAQ,SAAS,KAAuD,CAAC;AACzE,QAAA,MAAQ,oBAAoB,KAAyD,CAAC;AACtF,QAAA,MAAQ,KAAK,KAAgC,CAAC;AAC9C,QAAA,MAAM,CAAC,KAAyB,CAAC;AACjC,QAAA,MAAQ,wBAAwB,KAAwC,CAAC;AACzE,QAAA,MACC,kBAAkB,OAClB,qBAAqB,OACrB,uBAAuB,OACvB,eAAe,KACyB,CAAC;AAG1C,QAAA,MAAM,UAAU,WAIf,CAAC;AAKF,QAAA,MAAM,SAAS,KAqBb,CAAC;AAEH,QAAA,MAAM,GAAG,KAA+B,CAAC;AAEzC,QAAA,MAAM,MAAM,KAIV,CAAC;AA+BH,UAAU,oBAAoB;IAC5B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAsKD,iBAAe,IAAI,kBAOlB"}
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.js");
8
- const { introspectEndpoint, introspectLocalSchema, introspectSchemaFromUrl, introspectTypes, } = require("./helpers/introspection.js");
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
- server.tool("introspect-schema", "Introspect the GraphQL schema. Optionally filter to specific types.", {
72
- typeNames: z.array(z.string()).optional().describe("e.g., [\"Query\", \"User\"]"),
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
- server.tool("query-graphql", "Query a GraphQL endpoint with the given query and variables. Optionally pass headers (e.g., for Authorization).", {
109
- query: z.string(),
110
- variables: z.string().optional(),
111
- headers: z
112
- .string()
113
- .optional()
114
- .describe("Optional JSON string of headers to include, e.g., {\"Authorization\": \"Bearer ...\"}"),
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 transport = new StdioServerTransport();
218
- await server.connect(transport);
219
- console.error(`Started graphql mcp server ${env.NAME} for endpoint: ${env.ENDPOINT}`);
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
@@ -50,5 +50,5 @@
50
50
  "ts-node": "^10.9.2",
51
51
  "typescript": "5.8.3"
52
52
  },
53
- "version": "2.1.7"
53
+ "version": "2.1.9"
54
54
  }