subgraph-registry-mcp 0.2.2 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PaulieB14
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,9 @@
 # Subgraph Registry
 
+<a href="https://glama.ai/mcp/servers/PaulieB14/subgraph-registry">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/PaulieB14/subgraph-registry/badge" />
+</a>
+
 Agent-friendly semantic classification of all subgraphs on [The Graph Network](https://thegraph.com).
 
 Pre-computed index of 15,500+ subgraphs with domain classification, protocol type detection, schema fingerprinting, canonical entity mapping, and composite reliability scoring.
@@ -92,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
@@ -139,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
@@ -152,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
 {
@@ -165,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,7 @@
 {
   "name": "subgraph-registry-mcp",
-  "version": "0.2.2",
+  "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",
   "bin": {
@@ -11,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",
@@ -20,12 +23,19 @@
     "web3",
     "defi",
     "agent",
-    "ai"
+    "ai",
+    "openclaw",
+    "sse"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PaulieB14/subgraph-registry.git"
+  },
   "author": "PaulieB14",
   "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.2" },
+    { 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) => {