@letoribo/mcp-graphql-enhanced 3.4.0 → 3.5.1

package/README.md

@@ -3,6 +3,15 @@
 An **enhanced MCP (Model Context Protocol) server for GraphQL** that fixes real-world interoperability issues between LLMs and GraphQL APIs.
 > Drop-in replacement for `mcp-graphql` — with dynamic headers, robust variables parsing, and zero breaking changes.
 
+## 💬 Community & Support
+
+Join the conversation! If you have questions about using this bridge with Neo4j, Discord data graphs, or GraphQL in general, come hang out with us:
+
+* **Discord Channel:** [#mcp-graphql-enhanced](https://discord.com/channels/625400653321076807/1480510460339159184)
+* **Server:** The official **GraphQL Discord**
+
+This is the best place to share your feedback, report issues, or suggest new "enhanced" features for the bridge.
+
 ## ✨ Key Enhancements
 * ✅ **Built-in GraphiQL IDE** — Visual playground at http://localhost:MCP_PORT/ (or /graphiql) with pre-configured headers.
 * ✅ **Dual Transport** — Supports both **STDIO** (for local CLI/client tools) and **HTTP/JSON-RPC** (for external/browser clients).

package/dist/index.js

@@ -58,6 +58,7 @@ const env = EnvSchema.parse(process.env);
 const server = new mcp_js_1.McpServer({
     name: env.NAME,
     version: getVersion(),
+    description: "Start of the #mcp-graphql-enhanced channel on GraphQL server. Join here: https://discord.com/channels/622115132221685760/1348633379555184640"
 });
 // --- CACHE STATE ---
 let cachedSDL = null;
@@ -298,10 +299,15 @@ const introspectHandler = async ({ typeNames }) => {
             });
         }
         const coreEntities = Array.from(discoveredEntities).sort();
+        const communityHeader = [
+            `🌐 Community Channel: #mcp-graphql-enhanced`,
+            `🔗 Join the discussion: https://discord.com/channels/625400653321076807/1480510460339159184`,
+            `---`
+        ].join('\n');
         return {
             content: [{
                     type: "text",
-                    text: `${evolutionSummary}\n\n` + // Include the report from performUpdate
+                    text: `${communityHeader}\n${evolutionSummary}\n\n` + // Include the report from performUpdate
                         `GraphQL Schema Manifest [ID: ${schemaVersion}]\n\n` +
                         `ENTRY_POINT_ENTITIES: ${coreEntities.join(", ") || "None"}\n` +
                         `TOTAL_SCHEMA_TYPES: ${typeKeys.length}\n\n` +
@@ -369,18 +375,38 @@ async function handleHttpRequest(req, res) {
 }
 // --- STARTUP ---
 async function main() {
-    if (env.ENABLE_HTTP) {
+    const rawEnableHttp = process.env.ENABLE_HTTP;
+    // Determine if we should open the HTTP port.
+    // 1. Check if we're not running inside the MCP Inspector.
+    // 2. Ensure the user hasn't explicitly disabled HTTP (ENABLE_HTTP="false").
+    const isInspector = !!(process.env.MCP_INSPECTOR || process.env.INSPECTOR_PORT);
+    const shouldOpenPort = rawEnableHttp !== "false" && !isInspector;
+    if (shouldOpenPort) {
         const serverHttp = node_http_1.default.createServer(handleHttpRequest);
+        // Error handling to prevent crashes if the port is already in use
+        serverHttp.on('error', (e) => {
+            if (e.code !== 'EADDRINUSE')
+                console.error(`[HTTP-ERROR] ${e.message}`);
+        });
         serverHttp.listen(env.MCP_PORT, () => {
-            console.error(`[HTTP] Server started on http://localhost:${env.MCP_PORT}`);
-            console.error(`🎨 GraphiQL IDE: http://localhost:${env.MCP_PORT}/graphiql`);
-            console.error(`🤖 MCP Endpoint: http://localhost:${env.MCP_PORT}/mcp\n`);
+            // Log URLs only if HTTP is explicitly enabled
+            if (env.ENABLE_HTTP === true) {
+                console.error(`[HTTP] Server started on http://localhost:${env.MCP_PORT}`);
+                console.error(`🎨 GraphiQL IDE: http://localhost:${env.MCP_PORT}/graphiql`);
+            }
+            console.error(`🤖 MCP Endpoint: http://localhost:${env.MCP_PORT}/mcp`);
         });
     }
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);
-    console.error(`[STDIO] MCP Server "${env.NAME}" v${getVersion()} started`);
-    getSchema().catch(e => console.error(`[SCHEMA] Warning: Preload failed: ${e.message}`));
+    // Maintain quiet mode when running inside the Inspector to avoid protocol interference
+    if (!isInspector) {
+        console.error(`[STDIO] MCP Server "${env.NAME}" v${getVersion()} started`);
+    }
+    getSchema().catch(e => {
+        if (!isInspector)
+            console.error(`[SCHEMA] Warning: ${e.message}`);
+    });
 }
 process.on('SIGINT', () => process.exit(0));
 process.on('SIGTERM', () => process.exit(0));

package/package.json

@@ -50,5 +50,5 @@
 		"tsx": "^4.21.0",
 		"typescript": "5.8.3"
 	},
-	"version": "3.4.0"
+	"version": "3.5.1"
 }