@letoribo/mcpgql 1.2.0 → 1.2.2

package/README.md

@@ -0,0 +1,63 @@
+# mcpgql
+
+**The GraphQL Overlord’s bridge to MCP.**
+
+`mcpgql` is not just a client; it's a federated bridge connecting any GraphQL endpoint directly to the Model Context Protocol (MCP) ecosystem.
+
+---
+
+## Why mcpgql?
+
+- **Zero-Config Integration**: Seamlessly connect LLMs to your graph data.
+- **No Environment Pollution**: Unlike standard setups, no environment variables need to be declared in your `claude_desktop_config.json`. All configuration (endpoints, headers, mutation toggles) is handled dynamically in your terminal gateway.
+- **Federated Power**: Engineered to work flawlessly with `mcp-remote` for decentralized, multi-endpoint environments.
+- **Real-time Mutations**: Full support for write operations (like `publishToDiscord`) directly from your AI agent.
+
+## Quick Start
+
+Run the bridge via the terminal command:
+```
+mcpgql
+```
+The interactive dialog will automatically guide you through setting up your endpoints and required environment variables:
+```
+--- Select Endpoints (Enter to confirm) ---
+ [✓]  1. mcp
+ [ ]  2. neo4j
+--- Environment variables ---
+[YES] 3. Allow Mutations
+[OK] 4. Headers (Loaded from: /home/atman/headers.json)
+
+Enter number to toggle (or Enter to proceed):
+
+1. Terminal (HTTP GraphQL Gateway)
+2. MCP Inspector (stdio)
+Select mode (1 or 2): 1
+[INFO] Launching with ENDPOINT=https://mcp-discord.vercel.app/api/graphiql
+[DEBUG] Executing: node /home/mcp-graphql-enhanced/dist/index.js
+[BOOT] Initializing schema sync for: https://mcp-discord.vercel.app/api/graphiql
+[SYSTEM] Federated Bridge active on port 6274
+📡 MCP Endpoint: http://localhost:6274/mcp
+🎨 GraphiQL: http://localhost:6274/graphiql
+```
+
+## Integrate into Claude Desktop with a minimal configuration:
+```
+{
+  "mcpServers": {
+    "mcpgql": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "mcp-remote",
+        "http://localhost:6274/mcp"
+      ]
+    }
+  }
+}
+```
+## Proof of Concept
+
+- **Real-time Mutation**: Successfully executed complex GraphQL mutations (`publishToDiscord`) directly from the Claude interface.
+- **Integration Log**: [View the live integration proof for this session](https://claude.ai/share/7053179e-8cd7-47b6-bd88-a1f43b28539f).
+- **Success Status**: The integration verifies node querying and response transmission with 100% precision.

package/core.ts

@@ -13,23 +13,33 @@ interface Config {
 const rl = readline.createInterface({ input, output });
 const configPath = path.join(process.cwd(), 'mcpgql.config.json');
 const headersPath = path.join(process.cwd(), 'headers.json');
+const defaultConfigPath = path.join(__dirname, 'mcpgql.config.json');
+
+async function initializeFiles() {
+    // Check for mcpgql.config.json and offer to copy default if missing
+    if (!fs.existsSync(configPath)) {
+        console.log(`[INFO] Configuration file not found at: ${configPath}`);
+        if (fs.existsSync(defaultConfigPath)) {
+            const copyChoice = await rl.question('Do you want to copy the default configuration template here? (y/n): ');
+            if (copyChoice.toLowerCase() === 'y') {
+                fs.copyFileSync(defaultConfigPath, configPath);
+                console.log('[INFO] Default configuration copied to your current directory.');
+            } else {
+                console.log('[INFO] Please create mcpgql.config.json manually to proceed.');
+                process.exit(0);
+            }
+        } else {
+            console.error('[ERROR] Default template not found in package.');
+            process.exit(1);
+        }
+    }
 
-// Initialize the file with an empty object if it does not exist
-if (!fs.existsSync(headersPath)) {
-    fs.writeFileSync(headersPath, JSON.stringify({}, null, 2));
+    // Initialize headers.json with an empty object if it does not exist
+    if (!fs.existsSync(headersPath)) {
+        fs.writeFileSync(headersPath, JSON.stringify({}, null, 2));
+    }
 }
 
-const config: Config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-const entries: [string, string][] = Object.entries(config.endpoints);
-
-const selected = new Set<string>();
-if (entries.length > 0) selected.add(entries[0][0]);
-
-let allowMutations = false;
-
-// Load headers
-let headers = fs.readFileSync(headersPath, 'utf-8');
-
 function getDistPath(): string {
     let current = process.cwd();
     while (true) {
@@ -42,7 +52,12 @@ function getDistPath(): string {
     return path.join(path.dirname(require.resolve('@letoribo/mcp-graphql-enhanced/package.json')), 'dist/index.js');
 }
 
-async function startSelection() {
+async function startSelection(
+    entries: [string, string][], 
+    selected: Set<string>, 
+    allowMutations: { value: boolean }, 
+    headers: { value: string }
+) {
     const mutationIdx = entries.length + 1;
     const headersIdx = entries.length + 2;
 
@@ -54,11 +69,11 @@ async function startSelection() {
         });
 
         console.log('--- Environment variables ---');
-        const mutationStatus = allowMutations ? '[YES]' : '[NO]';
+        const mutationStatus = allowMutations.value ? '[YES]' : '[NO]';
         console.log(`${mutationStatus} ${mutationIdx}. Allow Mutations`);
         
         let hasAuth = false;
-        try { if (Object.keys(JSON.parse(headers)).length > 0) hasAuth = true; } catch (e) {}
+        try { if (Object.keys(JSON.parse(headers.value)).length > 0) hasAuth = true; } catch (e) {}
         console.log(`${hasAuth ? '[OK]' : '[  ]'} ${headersIdx}. Headers (Loaded from: ${headersPath})`);
 
         const choice = await rl.question('\nEnter number to toggle (or Enter to proceed): ');
@@ -71,17 +86,17 @@ async function startSelection() {
             const key = entries[idx][0];
             selected.has(key) ? selected.delete(key) : selected.add(key);
         } else if (choiceNum === mutationIdx) {
-            allowMutations = !allowMutations;
+            allowMutations.value = !allowMutations.value;
         } else if (choiceNum === headersIdx) {
             console.log('\n--- Paste JSON for headers.json ---');
-            console.log('Current: ' + headers);
+            console.log('Current: ' + headers.value);
             const input = await rl.question('Paste new JSON (e.g. {"Authorization": "..."}): ');
             
             if (input.trim() !== '') {
                 try {
                     const parsed = JSON.parse(input);
                     fs.writeFileSync(headersPath, JSON.stringify(parsed, null, 2));
-                    headers = JSON.stringify(parsed);
+                    headers.value = JSON.stringify(parsed);
                     console.log('[INFO] headers.json successfully updated.');
                 } catch (e) {
                     console.log('[ERROR] Invalid JSON! Update aborted.');
@@ -93,7 +108,17 @@ async function startSelection() {
 }
 
 async function main() {
-    await startSelection();
+    await initializeFiles();
+    
+    const config: Config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    const entries: [string, string][] = Object.entries(config.endpoints);
+    const selected = new Set<string>();
+    if (entries.length > 0) selected.add(entries[0][0]);
+    
+    const allowMutations = { value: false };
+    const headers = { value: fs.readFileSync(headersPath, 'utf-8') };
+
+    await startSelection(entries, selected, allowMutations, headers);
     
     const selectedUrls = Array.from(selected).map(k => config.endpoints[k]);
     if (selectedUrls.length === 0) {
@@ -109,8 +134,8 @@ async function main() {
     const spawnEnv: Record<string, string> = { 
         ...(process.env as Record<string, string>), 
         ENDPOINT: selectedUrls.join(','),
-        ALLOW_MUTATIONS: String(allowMutations),
-        HEADERS: headers
+        ALLOW_MUTATIONS: String(allowMutations.value),
+        HEADERS: headers.value
     };
 
     console.log(`[INFO] Launching with ENDPOINT=${spawnEnv.ENDPOINT}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letoribo/mcpgql",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "CLI tool for MCP GraphQL Enhanced",
   "main": "index.js",
   "bin": {