subgraph-registry-mcp 0.2.3 → 0.3.0

package/README.md

@@ -96,10 +96,15 @@ classifier.py - rule-based domain/protocol classification + schema fingerprintin
 registry.py --- builds JSON registry + SQLite + indices
     |
     v
-server.py ----- FastAPI REST API with /recommend endpoint
+server.py ----- FastAPI REST API with /recommend endpoint (:3847)
     |
     v
 scheduler.py -- weekly incremental sync via updatedAt filtering
+
+MCP Server (src/index.js)
+    |
+    ├── stdio transport  ←── Claude Desktop / Claude Code (npx command)
+    └── SSE/HTTP :3848   ←── OpenClaw / remote agents (--http flag)
 ```
 
 ## Output
@@ -143,7 +148,9 @@ All values are log-scaled and capped at 1.0. Usage signals (fees + volume) are w
 
 ## MCP Server
 
-The registry is available as an MCP server for agent integration. It exposes 4 tools:
+The registry is available as an MCP server for agent integration. It supports **dual transport** — stdio for local clients (Claude Desktop, Claude Code) and SSE/HTTP for remote agents (OpenClaw, custom agent frameworks).
+
+It exposes 4 tools:
 
 - **search_subgraphs** — filter by domain, network, protocol type, entity, or keyword
 - **recommend_subgraph** — natural language goal to best subgraphs
@@ -156,7 +163,7 @@ The registry is available as an MCP server for agent integration. It exposes 4 t
 npx subgraph-registry-mcp
 ```
 
-### Add to Claude Desktop
+### Add to Claude Desktop (stdio)
 
 ```json
 {
@@ -169,6 +176,43 @@ npx subgraph-registry-mcp
 }
 ```
 
+### Add to OpenClaw / Remote Agents (SSE)
+
+Start the server with the HTTP transport:
+
+```bash
+# Dual transport — stdio + SSE on port 3848
+npx subgraph-registry-mcp --http
+
+# SSE only (for remote/server deployments)
+npx subgraph-registry-mcp --http-only
+
+# Custom port
+MCP_HTTP_PORT=4000 npx subgraph-registry-mcp --http
+```
+
+Then point your agent at the SSE endpoint:
+
+```json
+{
+  "mcpServers": {
+    "subgraph-registry": {
+      "url": "http://localhost:3848/sse"
+    }
+  }
+}
+```
+
+### Transport Modes
+
+| Invocation | Transports | Use case |
+|---|---|---|
+| `npx subgraph-registry-mcp` | stdio | Claude Desktop, Claude Code |
+| `npx subgraph-registry-mcp --http` | stdio + SSE :3848 | Dual — local + remote agents |
+| `npx subgraph-registry-mcp --http-only` | SSE :3848 | OpenClaw, remote deployments |
+
+A `/health` endpoint is available at `http://localhost:3848/health` when HTTP transport is active.
+
 The server auto-downloads the pre-built registry (8MB SQLite) from GitHub on first run — no local build needed.
 
 ## How It Stays Current

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "subgraph-registry-mcp",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "mcpName": "io.github.PaulieB14/subgraph-registry-mcp",
   "description": "MCP server for agent-friendly subgraph discovery on The Graph Network. 15,500+ classified subgraphs with reliability scoring.",
   "type": "module",
@@ -12,7 +12,9 @@
     "data/registry.db"
   ],
   "scripts": {
-    "start": "node src/index.js"
+    "start": "node src/index.js",
+    "start:http": "node src/index.js --http",
+    "start:http-only": "node src/index.js --http-only"
   },
   "keywords": [
     "mcp",
@@ -21,7 +23,9 @@
     "web3",
     "defi",
     "agent",
-    "ai"
+    "ai",
+    "openclaw",
+    "sse"
   ],
   "repository": {
     "type": "git",
@@ -31,6 +35,7 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
-    "better-sqlite3": "^11.8.2"
+    "better-sqlite3": "^11.8.2",
+    "express": "^4.21.0"
   }
 }

package/src/index.js

@@ -15,11 +15,13 @@
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import {
   CallToolRequestSchema,
   ListToolsRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
 import Database from "better-sqlite3";
+import express from "express";
 import { fileURLToPath } from "url";
 import { dirname, join } from "path";
 import { existsSync, mkdirSync, writeFileSync } from "fs";
@@ -374,11 +376,9 @@ const HANDLERS = {
   list_registry_stats: listRegistryStats,
 };
 
-async function main() {
-  await ensureDb();
-
+function createServer() {
   const server = new Server(
-    { name: "subgraph-registry", version: "0.2.3" },
+    { name: "subgraph-registry", version: "0.3.0" },
     { capabilities: { tools: {} } }
   );
 
@@ -408,9 +408,70 @@ async function main() {
     }
   });
 
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error(`Subgraph Registry MCP server running (${getDb().prepare("SELECT COUNT(*) as c FROM subgraphs").get().c} subgraphs)`);
+  return server;
+}
+
+// ── SSE/HTTP Transport (OpenClaw + remote agents) ──────────
+
+function startHttpTransport(port) {
+  const app = express();
+  const sessions = new Map();
+
+  app.get("/sse", async (req, res) => {
+    const transport = new SSEServerTransport("/messages", res);
+    sessions.set(transport.sessionId, transport);
+
+    const server = createServer();
+
+    res.on("close", () => {
+      sessions.delete(transport.sessionId);
+    });
+
+    await server.connect(transport);
+  });
+
+  app.post("/messages", async (req, res) => {
+    const sessionId = req.query.sessionId;
+    const transport = sessions.get(sessionId);
+    if (!transport) {
+      res.status(400).json({ error: "Invalid or expired session" });
+      return;
+    }
+    await transport.handlePostMessage(req, res);
+  });
+
+  app.get("/health", (_req, res) => {
+    res.json({ status: "ok", subgraphs: getDb().prepare("SELECT COUNT(*) as c FROM subgraphs").get().c });
+  });
+
+  app.listen(port, () => {
+    console.error(`SSE transport listening on http://localhost:${port}/sse`);
+  });
+}
+
+// ── Entry Point ────────────────────────────────────────────
+
+async function main() {
+  await ensureDb();
+
+  const subgraphCount = getDb().prepare("SELECT COUNT(*) as c FROM subgraphs").get().c;
+  const httpPort = process.env.MCP_HTTP_PORT || (process.argv.includes("--http") ? "3848" : null);
+  const httpOnly = process.argv.includes("--http-only");
+
+  // Start SSE/HTTP transport if requested
+  if (httpPort || httpOnly) {
+    const port = parseInt(httpPort || "3848", 10);
+    startHttpTransport(port);
+  }
+
+  // Start stdio transport (default, skip if --http-only)
+  if (!httpOnly) {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+  }
+
+  console.error(`Subgraph Registry MCP server running (${subgraphCount} subgraphs)`);
 }
 
 main().catch((err) => {