@letoribo/mcp-graphql-enhanced 2.2.2 → 2.3.0

package/README.md

@@ -24,16 +24,24 @@ This allows external systems, web applications, and direct `curl` commands to ac
 | `/mcp` | `POST` | The main JSON-RPC endpoint for tool execution. |
 | `/health` | `GET` | Simple health check, returns `{ status: 'ok' }`. |
 
+### Resolving Port Conflicts (EADDRINUSE) and Automatic Port Selection
+
+The server defaults to port `6274`. If you encounter an `EADDRINUSE: address already in use :::6274` error (common in local development due to stale processes), the server will automatically **increment the port and retry** (e.g., bind to `6275`, then `6276`, etc., up to 5 times).
+
+This ensures the server starts successfully even when the default is blocked. **Always check the server logs for the final bound port** (e.g., `[HTTP] Started server on http://localhost:6275`) if your `curl` or client tool fails on the default `6274`.
+
+To **force a specific port** (e.g., for guaranteed external firewall settings), you can still explicitly set the `MCP_PORT` environment variable:
+
 ### Testing the HTTP Endpoint
 
 You can test the endpoint using `curl` as long as the server is running (e.g., via `npm run dev`):
 
 ```bash
-# Test the health check
+# Test the health check (assuming the server bound to the default or found the next available port)
 curl http://localhost:6274/health
 
-# Test the query tool via JSON-RPC
-curl -X POST http://localhost:6274/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"query-graphql","params":{"query":"query { __typename }"},"id":1}'
+# Example: Test the query tool via JSON-RPC (using port 6275 if 6274 was busy)
+curl -X POST http://localhost:6275/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","method":"query-graphql","params":{"query":"query { __typename }"},"id":1}'
 
 ## 🔍 Filtered Introspection (New!)
 Avoid 50k-line schema dumps. Ask for only what you need:

package/dist/index.js

@@ -1,13 +1,16 @@
 #!/usr/bin/env node
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const http = require("node:http");
+const node_http_1 = __importDefault(require("node:http"));
 const { McpServer } = require("@modelcontextprotocol/sdk/server/mcp.js");
 const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
 const { parse } = require("graphql/language");
 const z = require("zod").default;
-const { checkDeprecatedArguments } = require("./helpers/deprecation");
-const { introspectEndpoint, introspectLocalSchema, introspectSchemaFromUrl, introspectTypes, } = require("./helpers/introspection");
+const { checkDeprecatedArguments } = require("./helpers/deprecation.js");
+const { introspectEndpoint, introspectLocalSchema, introspectSchemaFromUrl, introspectTypes, } = require("./helpers/introspection.js");
 const getVersion = () => {
     const pkg = require("../package.json");
     return pkg.version;
@@ -299,10 +302,51 @@ async function handleHttpRequest(req, res) {
     res.writeHead(404, { 'Content-Type': 'text/plain' });
     res.end('Not Found. Use POST /mcp for JSON-RPC or GET /health.');
 }
+/**
+ * Tries to listen on a given port, automatically retrying on the next port if EADDRINUSE occurs.
+ * @param server - The HTTP server instance.
+ * @param port - The port to attempt binding to.
+ * @param maxRetries - Maximum number of retries.
+ * @param attempt - Current attempt number.
+ * @returns Resolves with the bound server instance.
+ */
+function tryListen(server, port, maxRetries = 5, attempt = 0) {
+    return new Promise((resolve, reject) => {
+        if (attempt >= maxRetries) {
+            reject(new Error(`Failed to bind HTTP server after ${maxRetries} attempts, starting from port ${env.MCP_PORT}.`));
+            return;
+        }
+        if (port > 65535) {
+            reject(new Error(`Exceeded maximum port number (65535) during retry.`));
+            return;
+        }
+        const errorHandler = (err) => {
+            server.removeListener('error', errorHandler); // Remove listener to prevent memory leak
+            if (err.code === 'EADDRINUSE') {
+                const nextPort = port + 1;
+                // Use console.error so it appears in the Inspector log
+                console.error(`[HTTP] Port ${port} is in use (EADDRINUSE). Retrying on ${nextPort}...`);
+                server.close(() => {
+                    // Recursively call tryListen with the next port
+                    resolve(tryListen(server, nextPort, maxRetries, attempt + 1));
+                });
+            }
+            else {
+                reject(err);
+            }
+        };
+        server.on('error', errorHandler);
+        server.listen(port, () => {
+            server.removeListener('error', errorHandler); // success, remove the error listener
+            console.error(`[HTTP] Started server on http://localhost:${port}. Listening for POST /mcp requests.`);
+            resolve(server);
+        });
+    });
+}
 function startHttpTransport() {
-    const server = http.createServer(handleHttpRequest);
-    server.listen(env.MCP_PORT, () => {
-        console.error(`[HTTP] Started server on http://localhost:${env.MCP_PORT}. Listening for POST /mcp requests.`);
+    const serverInstance = node_http_1.default.createServer(handleHttpRequest);
+    tryListen(serverInstance, env.MCP_PORT).catch((error) => {
+        console.error(`[HTTP] Failed to start HTTP transport: ${error.message}`);
     });
 }
 async function main() {

package/package.json

@@ -50,5 +50,5 @@
 		"ts-node": "^10.9.2",
 		"typescript": "5.8.3"
 	},
-	"version": "2.2.2"
+	"version": "2.3.0"
 }