@manhq/localmcp 1.0.1 → 1.0.2

package/docs/google-chat.md

@@ -43,34 +43,82 @@ http://localhost:47001/mcp/google-chat
 
 ## 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": {
     "google-chat": {
+      "type": "http",
       "url": "http://localhost:47001/mcp/google-chat"
     }
   }
 }
 ```
 
+**stdio** — `.claude/settings.local.json`
+```json
+{
+  "mcpServers": {
+    "google-chat": {
+      "type": "stdio",
+      "command": "localmcp",
+      "args": ["stdio", "google-chat"]
+    }
+  }
+}
+```
+
 Or register from the command line:
 ```bash
+# HTTP
 claude mcp add --transport http google-chat http://localhost:47001/mcp/google-chat
+
+# stdio
+claude mcp add google-chat localmcp stdio google-chat
 ```
 
-**Codex** — `~/.codex/config.toml`
+---
+
+### Codex
+
+**HTTP** — `~/.codex/config.toml`
 ```toml
 [mcp_servers.google-chat]
 url = "http://localhost:47001/mcp/google-chat"
 ```
 
+**stdio** — `~/.codex/config.toml`
+```toml
+[mcp_servers.google-chat]
+command = "localmcp"
+args = ["stdio", "google-chat"]
+```
+
 Or register from the command line:
 ```bash
+# HTTP
 codex mcp add google-chat --url http://localhost:47001/mcp/google-chat
+
+# stdio
+codex mcp add google-chat localmcp stdio google-chat
 ```
 
-**GitHub Copilot / VS Code** — `.vscode/mcp.json`
+---
+
+### GitHub Copilot / VS Code
+
+**HTTP** — `.vscode/mcp.json`
 ```json
 {
   "servers": {
@@ -82,7 +130,24 @@ codex mcp add google-chat --url http://localhost:47001/mcp/google-chat
 }
 ```
 
-**Cursor** — `.cursor/mcp.json`
+**stdio** — `.vscode/mcp.json`
+```json
+{
+  "servers": {
+    "google-chat": {
+      "type": "stdio",
+      "command": "localmcp",
+      "args": ["stdio", "google-chat"]
+    }
+  }
+}
+```
+
+---
+
+### Cursor
+
+**HTTP** — `.cursor/mcp.json`
 ```json
 {
   "mcpServers": {
@@ -93,7 +158,23 @@ codex mcp add google-chat --url http://localhost:47001/mcp/google-chat
 }
 ```
 
-**Windsurf** — `~/.codeium/windsurf/mcp_config.json`
+**stdio** — `.cursor/mcp.json`
+```json
+{
+  "mcpServers": {
+    "google-chat": {
+      "command": "localmcp",
+      "args": ["stdio", "google-chat"]
+    }
+  }
+}
+```
+
+---
+
+### Windsurf
+
+**HTTP** — `~/.codeium/windsurf/mcp_config.json`
 ```json
 {
   "mcpServers": {
@@ -104,7 +185,23 @@ codex mcp add google-chat --url http://localhost:47001/mcp/google-chat
 }
 ```
 
-**Antigravity** — `~/.gemini/config/mcp_config.json`
+**stdio** — `~/.codeium/windsurf/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "google-chat": {
+      "command": "localmcp",
+      "args": ["stdio", "google-chat"]
+    }
+  }
+}
+```
+
+---
+
+### Antigravity
+
+**HTTP** — `~/.gemini/config/mcp_config.json`
 ```json
 {
   "mcpServers": {
@@ -115,6 +212,48 @@ codex mcp add google-chat --url http://localhost:47001/mcp/google-chat
 }
 ```
 
+**stdio** — `~/.gemini/config/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "google-chat": {
+      "command": "localmcp",
+      "args": ["stdio", "google-chat"]
+    }
+  }
+}
+```
+
+---
+
+## REST API
+
+Call any Google Chat tool over plain HTTP — useful for scripts and automation.
+
+```bash
+# List all tools
+GET http://localhost:47001/api/google-chat
+
+# Call a tool
+POST http://localhost:47001/api/google-chat/search_conversations
+Content-Type: application/json
+
+{"query": "team standup"}
+
+POST http://localhost:47001/api/google-chat/send_message
+Content-Type: application/json
+
+{"conversationId": "spaces/AAAAAAA", "text": "Hello from the REST API!"}
+```
+
+Open the interactive playground:
+```bash
+localmcp playground
+# or: open http://localhost:47001/playground
+```
+
+---
+
 ## Tools
 
 | Tool | Description |

package/docs/vi/atlassian.md

@@ -33,34 +33,82 @@ http://localhost:47001/mcp/atlassian
 
 ## Đăng ký với AI Agents
 
-**Claude Code** — `.claude/settings.local.json`
+Mỗi agent hỗ trợ hai chế độ transport — chọn cái phù hợp với setup của bạn:
+
+- **HTTP** — cần server đang chạy (`localmcp`). Dùng chung giữa các agent.
+- **stdio** — agent tự spawn process khi cần. Không cần server chạy sẵn.
+
+Hoặc dùng `localmcp register` để đăng ký tự động.
+
+---
+
+### 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"]
+    }
+  }
+}
+```
+
 Hoặc đăng ký bằng 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"]
+```
+
 Hoặc đăng ký bằng 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
+
+Gọi bất kỳ tool Atlassian nào qua HTTP thông thường — tiện cho script và automation.
+
+```bash
+# Liệt kê tất cả tools
+GET http://localhost:47001/api/atlassian
+
+# Gọi một 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}
+```
+
+Mở interactive playground:
+```bash
+localmcp playground
+# hoặc: open http://localhost:47001/playground
+```
+
+---
+
 ## Danh sách tools
 
 ### Jira

package/docs/vi/figma.md

@@ -31,34 +31,82 @@ http://localhost:47001/mcp/figma
 
 ## Đăng ký với AI Agents
 
-**Claude Code** — `.claude/settings.local.json`
+Mỗi agent hỗ trợ hai chế độ transport — chọn cái phù hợp với setup của bạn:
+
+- **HTTP** — cần server đang chạy (`localmcp`). Dùng chung giữa các agent.
+- **stdio** — agent tự spawn process khi cần. Không cần server chạy sẵn.
+
+Hoặc dùng `localmcp register` để đăng ký tự động.
+
+---
+
+### 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"]
+    }
+  }
+}
+```
+
 Hoặc đăng ký bằng 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"]
+```
+
 Hoặc đăng ký bằng 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
+
+Gọi bất kỳ tool Figma nào qua HTTP thông thường — tiện cho script và automation.
+
+```bash
+# Liệt kê tất cả tools
+GET http://localhost:47001/api/figma
+
+# Gọi một 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}
+```
+
+Mở interactive playground:
+```bash
+localmcp playground
+# hoặc: open http://localhost:47001/playground
+```
+
+---
+
 ## Danh sách tools
 
 ### File & Node