@manhq/localmcp 1.0.1 → 1.0.2

package/docs/vi/google-chat.md

@@ -43,34 +43,82 @@ http://localhost:47001/mcp/google-chat
 
 ## Đă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": {
     "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"]
+    }
+  }
+}
+```
+
 Hoặc đăng ký bằng 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"]
+```
+
 Hoặc đăng ký bằng 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
+
+Gọi bất kỳ tool Google Chat 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/google-chat
+
+# Gọi một 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": "Xin chào từ REST API!"}
+```
+
+Mở interactive playground:
+```bash
+localmcp playground
+# hoặc: open http://localhost:47001/playground
+```
+
+---
+
 ## Danh sách tools
 
 | Tool | Mô tả |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manhq/localmcp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Local HTTP MCP server for Figma, Atlassian, and Google Chat with a single CLI.",
   "type": "module",
   "license": "UNLICENSED",
@@ -35,7 +35,7 @@
     "dev": "tsx watch src/index.ts",
     "build": "tsc",
     "start": "node dist/index.js",
-    "inspect": "npx @modelcontextprotocol/inspector --config mcp.json --server localmcp",
+    "inspect": "npx @modelcontextprotocol/inspector --config mcp.json",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
@@ -43,7 +43,8 @@
     "axios": "^1.7.9",
     "dotenv": "^16.4.7",
     "express": "^4.21.2",
-    "zod": "^3.24.2"
+    "zod": "^3.24.2",
+    "zod-to-json-schema": "^3.25.2"
   },
   "devDependencies": {
     "@types/express": "^5.0.0",