@manhq/localmcp 1.0.1 → 1.0.3

package/dist/index.js

@@ -3,10 +3,13 @@ import { fileURLToPath } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { env } from "./shared/env.js";
 import { registerFigmaTools } from "./services/figma/index.js";
 import { registerAtlassianTools } from "./services/atlassian/index.js";
 import { registerGChatTools } from "./services/google-chat/index.js";
+import { createMcpServerWithRegistry } from "./api/server-with-registry.js";
+import { mountRestApi } from "./api/rest.js";
 const SERVICE_REGISTRY = {
     figma: { register: registerFigmaTools, combinedPrefix: "figma", enabled: !!env.figma },
     atlassian: { register: registerAtlassianTools, combinedPrefix: "atlassian", enabled: !!env.atlassian },
@@ -15,9 +18,16 @@ const SERVICE_REGISTRY = {
 const activeServices = Object.entries(SERVICE_REGISTRY)
     .filter(([, s]) => s.enabled)
     .map(([name]) => name);
+// Populates REST registry AND returns a connected McpServer — used for warm-up and stdio.
 function createServiceServer(name) {
+    const server = createMcpServerWithRegistry(name, { name, version: "1.0.0" });
+    SERVICE_REGISTRY[name].register(server);
+    return server;
+}
+// Returns a plain McpServer without touching the REST registry — used per HTTP request
+// so the global registry is not re-populated on every MCP call.
+function createServiceServerOnly(name) {
     const server = new McpServer({ name, version: "1.0.0" });
-    // Per-service path: no prefix, tools keep their base names
     SERVICE_REGISTRY[name].register(server);
     return server;
 }
@@ -92,20 +102,26 @@ function makeCombinedServer() {
 export function createApp() {
     const app = express();
     app.use(express.json());
+    // Warm up registry by creating all service servers once (no transport needed)
+    for (const name of activeServices) {
+        createServiceServer(name);
+    }
     // Streamable HTTP — combined
     mountMcpHandler(app, "/mcp", makeCombinedServer);
     // Streamable HTTP — per-service: /mcp/figma, /mcp/atlassian, /mcp/google-chat
     for (const name of activeServices) {
         const service = name;
-        mountMcpHandler(app, `/mcp/${service}`, () => createServiceServer(service));
+        mountMcpHandler(app, `/mcp/${service}`, () => createServiceServerOnly(service));
     }
     // Legacy SSE (2024-11-05) — combined: GET /sse  →  POST /messages?sessionId=...
     mountLegacySseHandler(app, "/sse", "/messages", makeCombinedServer);
     // Legacy SSE — per-service: GET /sse/:service  →  POST /messages/:service?sessionId=...
     for (const name of activeServices) {
         const service = name;
-        mountLegacySseHandler(app, `/sse/${service}`, `/messages/${service}`, () => createServiceServer(service));
+        mountLegacySseHandler(app, `/sse/${service}`, `/messages/${service}`, () => createServiceServerOnly(service));
     }
+    // REST API + Playground
+    mountRestApi(app);
     app.get("/health", (_req, res) => {
         res.json({
             status: "ok",
@@ -119,6 +135,13 @@ export function createApp() {
                     combined: "/sse",
                     ...Object.fromEntries(activeServices.map((s) => [s, `/sse/${s}`])),
                 },
+                rest: {
+                    index: "/api",
+                    service: "/api/:service",
+                    call: "/api/:service/:tool",
+                    spec: "/api/openapi.json",
+                    playground: "/playground",
+                },
             },
         });
     });
@@ -127,14 +150,29 @@ export function createApp() {
 export function startServer() {
     createApp().listen(env.PORT, () => {
         const base = `http://localhost:${env.PORT}`;
+        const cliPath = fileURLToPath(new URL("cli.js", import.meta.url));
+        const stdioCmd = `${process.execPath} ${cliPath} stdio`;
         console.log(`Local MCP server running at ${base}`);
+        console.log(``);
         console.log(`  Streamable HTTP : ${base}/mcp`);
-        console.log(`  Legacy SSE      : ${base}/sse  (messages: ${base}/messages)`);
+        console.log(`  Legacy SSE      : ${base}/sse`);
         for (const s of activeServices) {
             console.log(`  [${s}]  ${base}/mcp/${s}  |  ${base}/sse/${s}`);
         }
+        console.log(`  REST API        : ${base}/api`);
+        console.log(`  Playground      : ${base}/playground`);
+        console.log(``);
+        console.log(`  stdio command   : ${stdioCmd}`);
+        for (const s of activeServices) {
+            console.log(`  stdio [${s}]  : ${process.execPath} ${cliPath} stdio ${s}`);
+        }
     });
 }
+export async function startStdio(service) {
+    const server = service ? createServiceServer(service) : makeCombinedServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
 if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
     startServer();
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/docs/atlassian.md

@@ -33,34 +33,82 @@ http://localhost:47001/mcp/atlassian
 
 ## Register with AI Agents
 
-**Claude Code** — `.claude/settings.local.json`
+Each agent supports two transports — pick whichever fits your setup:
+
+- **HTTP** — requires the server to be running (`localmcp`). Shared across agents.
+- **stdio** — the agent spawns the process on demand. No running server needed.
+
+Or use `localmcp register` to set up automatically.
+
+---
+
+### Claude Code
+
+**HTTP** — `.claude/settings.local.json`
 ```json
 {
   "mcpServers": {
     "atlassian": {
+      "type": "http",
       "url": "http://localhost:47001/mcp/atlassian"
     }
   }
 }
 ```
 
+**stdio** — `.claude/settings.local.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "type": "stdio",
+      "command": "localmcp",
+      "args": ["stdio", "atlassian"]
+    }
+  }
+}
+```
+
 Or register from the command line:
 ```bash
+# HTTP
 claude mcp add --transport http atlassian http://localhost:47001/mcp/atlassian
+
+# stdio
+claude mcp add atlassian localmcp stdio atlassian
 ```
 
-**Codex** — `~/.codex/config.toml`
+---
+
+### Codex
+
+**HTTP** — `~/.codex/config.toml`
 ```toml
 [mcp_servers.atlassian]
 url = "http://localhost:47001/mcp/atlassian"
 ```
 
+**stdio** — `~/.codex/config.toml`
+```toml
+[mcp_servers.atlassian]
+command = "localmcp"
+args = ["stdio", "atlassian"]
+```
+
 Or register from the command line:
 ```bash
+# HTTP
 codex mcp add atlassian --url http://localhost:47001/mcp/atlassian
+
+# stdio
+codex mcp add atlassian localmcp stdio atlassian
 ```
 
-**GitHub Copilot / VS Code** — `.vscode/mcp.json`
+---
+
+### GitHub Copilot / VS Code
+
+**HTTP** — `.vscode/mcp.json`
 ```json
 {
   "servers": {
@@ -72,7 +120,24 @@ codex mcp add atlassian --url http://localhost:47001/mcp/atlassian
 }
 ```
 
-**Cursor** — `.cursor/mcp.json`
+**stdio** — `.vscode/mcp.json`
+```json
+{
+  "servers": {
+    "atlassian": {
+      "type": "stdio",
+      "command": "localmcp",
+      "args": ["stdio", "atlassian"]
+    }
+  }
+}
+```
+
+---
+
+### Cursor
+
+**HTTP** — `.cursor/mcp.json`
 ```json
 {
   "mcpServers": {
@@ -83,7 +148,23 @@ codex mcp add atlassian --url http://localhost:47001/mcp/atlassian
 }
 ```
 
-**Windsurf** — `~/.codeium/windsurf/mcp_config.json`
+**stdio** — `.cursor/mcp.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "command": "localmcp",
+      "args": ["stdio", "atlassian"]
+    }
+  }
+}
+```
+
+---
+
+### Windsurf
+
+**HTTP** — `~/.codeium/windsurf/mcp_config.json`
 ```json
 {
   "mcpServers": {
@@ -94,7 +175,23 @@ codex mcp add atlassian --url http://localhost:47001/mcp/atlassian
 }
 ```
 
-**Antigravity** — `~/.gemini/config/mcp_config.json`
+**stdio** — `~/.codeium/windsurf/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "command": "localmcp",
+      "args": ["stdio", "atlassian"]
+    }
+  }
+}
+```
+
+---
+
+### Antigravity
+
+**HTTP** — `~/.gemini/config/mcp_config.json`
 ```json
 {
   "mcpServers": {
@@ -105,6 +202,48 @@ codex mcp add atlassian --url http://localhost:47001/mcp/atlassian
 }
 ```
 
+**stdio** — `~/.gemini/config/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "command": "localmcp",
+      "args": ["stdio", "atlassian"]
+    }
+  }
+}
+```
+
+---
+
+## REST API
+
+Call any Atlassian tool over plain HTTP — useful for scripts and automation.
+
+```bash
+# List all tools
+GET http://localhost:47001/api/atlassian
+
+# Call a tool
+POST http://localhost:47001/api/atlassian/getJiraIssue
+Content-Type: application/json
+
+{"issueIdOrKey": "PROJ-123"}
+
+POST http://localhost:47001/api/atlassian/searchJiraIssuesUsingJql
+Content-Type: application/json
+
+{"jql": "project = PROJ AND status = \"In Progress\"", "maxResults": 20}
+```
+
+Open the interactive playground:
+```bash
+localmcp playground
+# or: open http://localhost:47001/playground
+```
+
+---
+
 ## Tools
 
 ### Jira

package/docs/figma.md

@@ -31,34 +31,82 @@ http://localhost:47001/mcp/figma
 
 ## Register with AI Agents
 
-**Claude Code** — `.claude/settings.local.json`
+Each agent supports two transports — pick whichever fits your setup:
+
+- **HTTP** — requires the server to be running (`localmcp`). Shared across agents.
+- **stdio** — the agent spawns the process on demand. No running server needed.
+
+Or use `localmcp register` to set up automatically.
+
+---
+
+### Claude Code
+
+**HTTP** — `.claude/settings.local.json`
 ```json
 {
   "mcpServers": {
     "figma": {
+      "type": "http",
       "url": "http://localhost:47001/mcp/figma"
     }
   }
 }
 ```
 
+**stdio** — `.claude/settings.local.json`
+```json
+{
+  "mcpServers": {
+    "figma": {
+      "type": "stdio",
+      "command": "localmcp",
+      "args": ["stdio", "figma"]
+    }
+  }
+}
+```
+
 Or register from the command line:
 ```bash
+# HTTP
 claude mcp add --transport http figma http://localhost:47001/mcp/figma
+
+# stdio
+claude mcp add figma localmcp stdio figma
 ```
 
-**Codex** — `~/.codex/config.toml`
+---
+
+### Codex
+
+**HTTP** — `~/.codex/config.toml`
 ```toml
 [mcp_servers.figma]
 url = "http://localhost:47001/mcp/figma"
 ```
 
+**stdio** — `~/.codex/config.toml`
+```toml
+[mcp_servers.figma]
+command = "localmcp"
+args = ["stdio", "figma"]
+```
+
 Or register from the command line:
 ```bash
+# HTTP
 codex mcp add figma --url http://localhost:47001/mcp/figma
+
+# stdio
+codex mcp add figma localmcp stdio figma
 ```
 
-**GitHub Copilot / VS Code** — `.vscode/mcp.json`
+---
+
+### GitHub Copilot / VS Code
+
+**HTTP** — `.vscode/mcp.json`
 ```json
 {
   "servers": {
@@ -70,7 +118,24 @@ codex mcp add figma --url http://localhost:47001/mcp/figma
 }
 ```
 
-**Cursor** — `.cursor/mcp.json`
+**stdio** — `.vscode/mcp.json`
+```json
+{
+  "servers": {
+    "figma": {
+      "type": "stdio",
+      "command": "localmcp",
+      "args": ["stdio", "figma"]
+    }
+  }
+}
+```
+
+---
+
+### Cursor
+
+**HTTP** — `.cursor/mcp.json`
 ```json
 {
   "mcpServers": {
@@ -81,7 +146,23 @@ codex mcp add figma --url http://localhost:47001/mcp/figma
 }
 ```
 
-**Windsurf** — `~/.codeium/windsurf/mcp_config.json`
+**stdio** — `.cursor/mcp.json`
+```json
+{
+  "mcpServers": {
+    "figma": {
+      "command": "localmcp",
+      "args": ["stdio", "figma"]
+    }
+  }
+}
+```
+
+---
+
+### Windsurf
+
+**HTTP** — `~/.codeium/windsurf/mcp_config.json`
 ```json
 {
   "mcpServers": {
@@ -92,7 +173,23 @@ codex mcp add figma --url http://localhost:47001/mcp/figma
 }
 ```
 
-**Antigravity** — `~/.gemini/config/mcp_config.json`
+**stdio** — `~/.codeium/windsurf/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "figma": {
+      "command": "localmcp",
+      "args": ["stdio", "figma"]
+    }
+  }
+}
+```
+
+---
+
+### Antigravity
+
+**HTTP** — `~/.gemini/config/mcp_config.json`
 ```json
 {
   "mcpServers": {
@@ -103,6 +200,48 @@ codex mcp add figma --url http://localhost:47001/mcp/figma
 }
 ```
 
+**stdio** — `~/.gemini/config/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "figma": {
+      "command": "localmcp",
+      "args": ["stdio", "figma"]
+    }
+  }
+}
+```
+
+---
+
+## REST API
+
+Call any Figma tool over plain HTTP — useful for scripts and automation.
+
+```bash
+# List all tools
+GET http://localhost:47001/api/figma
+
+# Call a tool
+POST http://localhost:47001/api/figma/figma_whoami
+Content-Type: application/json
+
+{}
+
+POST http://localhost:47001/api/figma/figma_get_metadata
+Content-Type: application/json
+
+{"fileKey": "AbCdEfGh", "depth": 2}
+```
+
+Open the interactive playground:
+```bash
+localmcp playground
+# or: open http://localhost:47001/playground
+```
+
+---
+
 ## Tools
 
 ### File & Node