@manhq/localmcp 1.0.0

package/docs/vi/figma.md

@@ -0,0 +1,154 @@
+# Figma
+
+[English](../figma.md) | [Tiếng Việt](figma.md)
+
+Tích hợp Figma API — cho phép đọc file thiết kế, lấy design tokens, xuất ảnh, và quản lý bình luận.
+
+## Biến môi trường
+
+| Biến | Bắt buộc | Mô tả |
+|------|----------|-------|
+| `FIGMA_HOST` | Có | Địa chỉ API, mặc định `https://api.figma.com/v1` |
+| `FIGMA_TOKEN` | Có | Personal access token từ cài đặt tài khoản Figma |
+
+Service chỉ được bật khi **cả hai** biến trên có giá trị.
+
+### Lấy token
+
+1. Vào [Figma Account Settings](https://www.figma.com/settings)
+2. Cuộn xuống phần **Personal access tokens** → tạo token mới
+3. Điền vào `.env`:
+   ```
+   FIGMA_HOST=https://api.figma.com/v1
+   FIGMA_TOKEN=figd_xxxxxxxxxxxx
+   ```
+
+## Endpoint MCP
+
+```
+http://localhost:47001/mcp/figma
+```
+
+## Đăng ký với AI Agents
+
+**Claude Code** — `.claude/settings.local.json`
+```json
+{
+  "mcpServers": {
+    "figma": {
+      "url": "http://localhost:47001/mcp/figma"
+    }
+  }
+}
+```
+
+Hoặc đăng ký bằng command line:
+```bash
+claude mcp add --transport http figma http://localhost:47001/mcp/figma
+```
+
+**Codex** — `~/.codex/config.toml`
+```toml
+[mcp_servers.figma]
+url = "http://localhost:47001/mcp/figma"
+```
+
+Hoặc đăng ký bằng command line:
+```bash
+codex mcp add figma --url http://localhost:47001/mcp/figma
+```
+
+**GitHub Copilot / VS Code** — `.vscode/mcp.json`
+```json
+{
+  "servers": {
+    "figma": {
+      "type": "http",
+      "url": "http://localhost:47001/mcp/figma"
+    }
+  }
+}
+```
+
+**Cursor** — `.cursor/mcp.json`
+```json
+{
+  "mcpServers": {
+    "figma": {
+      "url": "http://localhost:47001/mcp/figma"
+    }
+  }
+}
+```
+
+**Windsurf** — `~/.codeium/windsurf/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "figma": {
+      "serverUrl": "http://localhost:47001/mcp/figma"
+    }
+  }
+}
+```
+
+**Antigravity** — `~/.gemini/config/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "figma": {
+      "serverUrl": "http://localhost:47001/mcp/figma"
+    }
+  }
+}
+```
+
+## Danh sách tools
+
+### File & Node
+
+| Tool | Mô tả |
+|------|-------|
+| `figma_get_metadata` | Lấy cấu trúc cây của file hoặc một node cụ thể: tên, ID, kiểu, bounding box. Dùng trước khi lấy chi tiết thiết kế. |
+| `figma_get_design_context` | Lấy toàn bộ thuộc tính thiết kế của một node: màu sắc, typography, auto-layout, effects, constraints. |
+
+### Bình luận
+
+| Tool | Mô tả |
+|------|-------|
+| `figma_get_comments` | Lấy tất cả bình luận trong file: nội dung, tác giả, ngày tạo, trạng thái resolved. |
+| `figma_post_comment` | Đăng bình luận lên file. Có thể gắn vào node cụ thể qua `nodeId`. |
+
+### Design Tokens
+
+| Tool | Mô tả |
+|------|-------|
+| `figma_get_variables` | Lấy tất cả biến thiết kế cục bộ trong file: màu, spacing, typography, border-radius, v.v. |
+| `figma_get_published_variables` | Lấy các biến thiết kế đã được publish từ file thư viện. |
+
+### Ảnh & Assets
+
+| Tool | Mô tả |
+|------|-------|
+| `figma_export_image` | Xuất node thành ảnh, trả về URL tải tạm thời. Hỗ trợ PNG, JPG, SVG, PDF. |
+| `figma_get_image_fills` | Lấy URL tải ảnh cho tất cả image fills được nhúng trong file. |
+
+### Components & Styles
+
+| Tool | Mô tả |
+|------|-------|
+| `figma_get_components` | Lấy danh sách components đã publish trong file: tên, mô tả, node ID. |
+| `figma_get_component_sets` | Lấy danh sách component sets (nhóm variants) trong file. |
+| `figma_get_styles` | Lấy tất cả styles đã publish: color styles, text styles, effect styles, grid styles. |
+| `figma_get_team_components` | Lấy components từ tất cả thư viện dùng chung của team. Cần `teamId`. |
+
+### Tài khoản
+
+| Tool | Mô tả |
+|------|-------|
+| `figma_whoami` | Xem thông tin tài khoản Figma đang được xác thực: tên, email, account ID. |
+
+## Tìm fileKey và nodeId
+
+- **fileKey**: chuỗi trong URL của file Figma, ví dụ `https://www.figma.com/file/`**`AbCdEfGh`**`/Ten-file`
+- **nodeId**: có dạng `123:456`, lấy từ URL khi chọn một layer, hoặc dùng `figma_get_metadata` để duyệt cây.

package/docs/vi/google-chat.md

@@ -0,0 +1,130 @@
+# Google Chat
+
+[English](../google-chat.md) | [Tiếng Việt](google-chat.md)
+
+Tích hợp Google Chat API — tìm kiếm conversations, đọc và gửi tin nhắn. Tool set tương đương [Google Chat MCP server](https://developers.google.com/workspace/chat/api/reference/mcp) chính thức.
+
+## Biến môi trường
+
+| Biến | Bắt buộc | Mô tả |
+|------|----------|-------|
+| `GCHAT_CLIENT_ID` | Có | OAuth 2.0 Client ID |
+| `GCHAT_CLIENT_SECRET` | Có | OAuth 2.0 Client Secret |
+| `GCHAT_REFRESH_TOKEN` | Có | OAuth 2.0 Refresh Token |
+
+Service chỉ được bật khi **cả ba** biến trên có giá trị.
+
+### Lấy credentials
+
+1. Vào [Google Cloud Console](https://console.cloud.google.com) → tạo hoặc chọn project
+2. Bật **Google Chat API**
+3. Vào **APIs & Services → Credentials → Create Credentials → OAuth client ID**
+   - Application type: **Web application**
+   - Authorized redirect URIs: `http://localhost`
+4. Sao chép **Client ID** và **Client Secret**
+5. Lấy Refresh Token — chạy OAuth flow với các scopes sau:
+   ```
+   https://www.googleapis.com/auth/chat.spaces.readonly
+   https://www.googleapis.com/auth/chat.messages.readonly
+   https://www.googleapis.com/auth/chat.messages.create
+   ```
+6. Điền vào `.env`:
+   ```
+   GCHAT_CLIENT_ID=xxxx.apps.googleusercontent.com
+   GCHAT_CLIENT_SECRET=GOCSPX-xxxx
+   GCHAT_REFRESH_TOKEN=1//xxxx
+   ```
+
+## Endpoint MCP
+
+```
+http://localhost:47001/mcp/google-chat
+```
+
+## Đăng ký với AI Agents
+
+**Claude Code** — `.claude/settings.local.json`
+```json
+{
+  "mcpServers": {
+    "google-chat": {
+      "url": "http://localhost:47001/mcp/google-chat"
+    }
+  }
+}
+```
+
+Hoặc đăng ký bằng command line:
+```bash
+claude mcp add --transport http google-chat http://localhost:47001/mcp/google-chat
+```
+
+**Codex** — `~/.codex/config.toml`
+```toml
+[mcp_servers.google-chat]
+url = "http://localhost:47001/mcp/google-chat"
+```
+
+Hoặc đăng ký bằng command line:
+```bash
+codex mcp add google-chat --url http://localhost:47001/mcp/google-chat
+```
+
+**GitHub Copilot / VS Code** — `.vscode/mcp.json`
+```json
+{
+  "servers": {
+    "google-chat": {
+      "type": "http",
+      "url": "http://localhost:47001/mcp/google-chat"
+    }
+  }
+}
+```
+
+**Cursor** — `.cursor/mcp.json`
+```json
+{
+  "mcpServers": {
+    "google-chat": {
+      "url": "http://localhost:47001/mcp/google-chat"
+    }
+  }
+}
+```
+
+**Windsurf** — `~/.codeium/windsurf/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "google-chat": {
+      "serverUrl": "http://localhost:47001/mcp/google-chat"
+    }
+  }
+}
+```
+
+**Antigravity** — `~/.gemini/config/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "google-chat": {
+      "serverUrl": "http://localhost:47001/mcp/google-chat"
+    }
+  }
+}
+```
+
+## Danh sách tools
+
+| Tool | Mô tả |
+|------|-------|
+| `search_conversations` | Tìm kiếm spaces, DMs, group DMs theo tên hoặc danh sách participants |
+| `list_messages` | Lấy tin nhắn từ một conversation. Có thể lọc theo thread, khoảng thời gian, hỗ trợ phân trang |
+| `search_messages` | Tìm kiếm tin nhắn theo keywords, sender, thời gian, mention, v.v. |
+| `send_message` | Gửi tin nhắn vào một conversation. Hỗ trợ reply vào thread cụ thể |
+
+## Lấy conversationId và threadId
+
+- **conversationId**: resource name của space, dạng `spaces/AAAAAAA`. Lấy bằng `search_conversations`.
+- **threadId**: resource name của thread, dạng `spaces/AAAAAAA/threads/BBBBBBB`. Lấy từ field `thread.name` trong kết quả `list_messages`.

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@manhq/localmcp",
+  "version": "1.0.0",
+  "description": "Local HTTP MCP server for Figma, Atlassian, and Google Chat with a single CLI.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "figma",
+    "jira",
+    "confluence",
+    "google-chat"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "bin",
+    "dist",
+    "docs",
+    "README.md",
+    "README.vi.md"
+  ],
+  "bin": {
+    "localmcp": "bin/localmcp.js"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector --config mcp.json --server localmcp",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "axios": "^1.7.9",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.7",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  }
+}