@manhq/localmcp 1.0.0

package/docs/atlassian.md

@@ -0,0 +1,170 @@
+# Atlassian
+
+[English](atlassian.md) | [Tiếng Việt](vi/atlassian.md)
+
+Integrates Jira and Confluence through the Atlassian REST API.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `ATLASSIAN_HOST` | Yes | Organization URL, for example `https://yourcompany.atlassian.net` |
+| `ATLASSIAN_EMAIL` | Yes | Atlassian account email |
+| `ATLASSIAN_API_TOKEN` | Yes | API token from Atlassian account settings |
+
+The service is enabled only when **all three** variables are set.
+
+### Get an API Token
+
+1. Go to [Atlassian API tokens](https://id.atlassian.com/manage-profile/security/api-tokens)
+2. Create a new token and copy its value
+3. Add it to `.env`:
+   ```
+   ATLASSIAN_HOST=https://yourcompany.atlassian.net
+   ATLASSIAN_EMAIL=your@email.com
+   ATLASSIAN_API_TOKEN=ATATT3xxxxx
+   ```
+
+## MCP Endpoint
+
+```
+http://localhost:47001/mcp/atlassian
+```
+
+## Register with AI Agents
+
+**Claude Code** — `.claude/settings.local.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "url": "http://localhost:47001/mcp/atlassian"
+    }
+  }
+}
+```
+
+Or register from the command line:
+```bash
+claude mcp add --transport http atlassian http://localhost:47001/mcp/atlassian
+```
+
+**Codex** — `~/.codex/config.toml`
+```toml
+[mcp_servers.atlassian]
+url = "http://localhost:47001/mcp/atlassian"
+```
+
+Or register from the command line:
+```bash
+codex mcp add atlassian --url http://localhost:47001/mcp/atlassian
+```
+
+**GitHub Copilot / VS Code** — `.vscode/mcp.json`
+```json
+{
+  "servers": {
+    "atlassian": {
+      "type": "http",
+      "url": "http://localhost:47001/mcp/atlassian"
+    }
+  }
+}
+```
+
+**Cursor** — `.cursor/mcp.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "url": "http://localhost:47001/mcp/atlassian"
+    }
+  }
+}
+```
+
+**Windsurf** — `~/.codeium/windsurf/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "serverUrl": "http://localhost:47001/mcp/atlassian"
+    }
+  }
+}
+```
+
+**Antigravity** — `~/.gemini/config/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "serverUrl": "http://localhost:47001/mcp/atlassian"
+    }
+  }
+}
+```
+
+## Tools
+
+### Jira
+
+| Tool | Description |
+|------|-------------|
+| `getJiraIssue` | Gets issue details by ID or key, for example `PROJECT-123`. |
+| `searchJiraIssuesUsingJql` | Searches issues with JQL. |
+| `createJiraIssue` | Creates a new issue in a project. |
+| `editJiraIssue` | Updates summary, description, assignee, or priority. |
+| `transitionJiraIssue` | Moves an issue through workflow states, for example to "In Progress" or "Done". |
+| `getTransitionsForJiraIssue` | Lists available transitions for an issue. |
+| `addCommentToJiraIssue` | Adds a comment to an issue. |
+| `addWorklogToJiraIssue` | Logs work time on an issue. |
+| `getVisibleJiraProjects` | Lists all projects the account can access. |
+| `getJiraProjectIssueTypesMetadata` | Lists issue types in a project. |
+| `getJiraIssueTypeMetaWithFields` | Gets field metadata for creating a specific issue type. |
+| `getIssueLinkTypes` | Lists issue link types, such as blocks or duplicates. |
+| `getJiraIssueRemoteIssueLinks` | Lists external links attached to an issue, for example Confluence pages. |
+| `lookupJiraAccountId` | Finds a user's account ID by name or email. |
+
+### Confluence
+
+| Tool | Description |
+|------|-------------|
+| `getConfluencePage` | Gets page content by ID. |
+| `getConfluencePageDescendants` | Lists child pages for a page. |
+| `getConfluencePageFooterComments` | Gets footer comments on a page. |
+| `getConfluencePageInlineComments` | Gets inline comments attached to specific text. |
+| `getConfluenceCommentChildren` | Shows replies to a comment. |
+| `getConfluenceSpaces` | Lists all spaces the account can access. |
+| `getPagesInConfluenceSpace` | Lists pages in a space. |
+| `createConfluencePage` | Creates a new page in a space. |
+| `updateConfluencePage` | Updates page content or title. Requires the current version number. |
+| `createConfluenceFooterComment` | Adds a footer comment or reply to a page. |
+| `createConfluenceInlineComment` | Creates an inline comment attached to specific text. |
+| `searchConfluenceUsingCql` | Searches content with CQL. |
+
+## Common JQL Examples
+
+```
+# Issues in progress in the current sprint
+project = PROJ AND sprint in openSprints() AND status = "In Progress"
+
+# Unresolved high-priority bugs
+project = PROJ AND issuetype = Bug AND priority in (High, Highest) AND status != Done
+
+# Issues assigned to me
+assignee = currentUser() AND status != Done ORDER BY created DESC
+```
+
+## Common CQL Examples
+
+```
+# Find pages in a space by title
+space = "DEV" AND title ~ "API" AND type = page
+
+# Find recently edited content
+lastModified > now("-7d") ORDER BY lastModified DESC
+
+# Find pages created by a specific user
+creator = "user@email.com" AND type = page
+```

package/docs/figma.md

@@ -0,0 +1,154 @@
+# Figma
+
+[English](figma.md) | [Tiếng Việt](vi/figma.md)
+
+Integrates the Figma API, allowing agents to read design files, retrieve design tokens, export images, and manage comments.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `FIGMA_HOST` | Yes | API base URL, defaults to `https://api.figma.com/v1` |
+| `FIGMA_TOKEN` | Yes | Personal access token from Figma account settings |
+
+The service is enabled only when **both** variables are set.
+
+### Get a Token
+
+1. Go to [Figma Account Settings](https://www.figma.com/settings)
+2. Scroll to **Personal access tokens** and create a new token
+3. Add it to `.env`:
+   ```
+   FIGMA_HOST=https://api.figma.com/v1
+   FIGMA_TOKEN=figd_xxxxxxxxxxxx
+   ```
+
+## MCP Endpoint
+
+```
+http://localhost:47001/mcp/figma
+```
+
+## Register with AI Agents
+
+**Claude Code** — `.claude/settings.local.json`
+```json
+{
+  "mcpServers": {
+    "figma": {
+      "url": "http://localhost:47001/mcp/figma"
+    }
+  }
+}
+```
+
+Or register from the 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"
+```
+
+Or register from the 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"
+    }
+  }
+}
+```
+
+## Tools
+
+### File & Node
+
+| Tool | Description |
+|------|-------------|
+| `figma_get_metadata` | Gets the file tree or a specific node: name, ID, type, and bounding box. Use before reading detailed design data. |
+| `figma_get_design_context` | Gets full design properties for a node: colors, typography, auto-layout, effects, and constraints. |
+
+### Comments
+
+| Tool | Description |
+|------|-------------|
+| `figma_get_comments` | Gets all comments in a file: content, author, creation date, and resolved state. |
+| `figma_post_comment` | Posts a comment to a file. Can attach to a specific node via `nodeId`. |
+
+### Design Tokens
+
+| Tool | Description |
+|------|-------------|
+| `figma_get_variables` | Gets all local design variables in a file: colors, spacing, typography, radius, and more. |
+| `figma_get_published_variables` | Gets design variables published from a library file. |
+
+### Images & Assets
+
+| Tool | Description |
+|------|-------------|
+| `figma_export_image` | Exports a node as an image and returns a temporary download URL. Supports PNG, JPG, SVG, and PDF. |
+| `figma_get_image_fills` | Gets download URLs for all image fills embedded in the file. |
+
+### Components & Styles
+
+| Tool | Description |
+|------|-------------|
+| `figma_get_components` | Gets published components in the file: name, description, and node ID. |
+| `figma_get_component_sets` | Gets component sets, meaning variant groups, in the file. |
+| `figma_get_styles` | Gets all published styles: color styles, text styles, effect styles, and grid styles. |
+| `figma_get_team_components` | Gets components from all shared team libraries. Requires `teamId`. |
+
+### Account
+
+| Tool | Description |
+|------|-------------|
+| `figma_whoami` | Shows the authenticated Figma account: name, email, and account ID. |
+
+## Find fileKey and nodeId
+
+- **fileKey**: the string in the Figma file URL, for example `https://www.figma.com/file/`**`AbCdEfGh`**`/File-name`
+- **nodeId**: usually shaped like `123:456`; get it from the URL after selecting a layer, or use `figma_get_metadata` to browse the tree.

package/docs/google-chat.md

@@ -0,0 +1,130 @@
+# Google Chat
+
+[English](google-chat.md) | [Tiếng Việt](vi/google-chat.md)
+
+Integrates the Google Chat API to search conversations, read messages, and send messages. The tool set is equivalent to the official [Google Chat MCP server](https://developers.google.com/workspace/chat/api/reference/mcp).
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `GCHAT_CLIENT_ID` | Yes | OAuth 2.0 Client ID |
+| `GCHAT_CLIENT_SECRET` | Yes | OAuth 2.0 Client Secret |
+| `GCHAT_REFRESH_TOKEN` | Yes | OAuth 2.0 Refresh Token |
+
+The service is enabled only when **all three** variables are set.
+
+### Get Credentials
+
+1. Go to [Google Cloud Console](https://console.cloud.google.com), then create or select a project
+2. Enable **Google Chat API**
+3. Go to **APIs & Services -> Credentials -> Create Credentials -> OAuth client ID**
+   - Application type: **Web application**
+   - Authorized redirect URIs: `http://localhost`
+4. Copy **Client ID** and **Client Secret**
+5. Get a Refresh Token by running an OAuth flow with these scopes:
+   ```
+   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. Add credentials to `.env`:
+   ```
+   GCHAT_CLIENT_ID=xxxx.apps.googleusercontent.com
+   GCHAT_CLIENT_SECRET=GOCSPX-xxxx
+   GCHAT_REFRESH_TOKEN=1//xxxx
+   ```
+
+## MCP Endpoint
+
+```
+http://localhost:47001/mcp/google-chat
+```
+
+## Register with AI Agents
+
+**Claude Code** — `.claude/settings.local.json`
+```json
+{
+  "mcpServers": {
+    "google-chat": {
+      "url": "http://localhost:47001/mcp/google-chat"
+    }
+  }
+}
+```
+
+Or register from the 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"
+```
+
+Or register from the 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"
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_conversations` | Searches spaces, DMs, and group DMs by name or participant list. |
+| `list_messages` | Gets messages from a conversation. Supports filtering by thread, time range, and pagination. |
+| `search_messages` | Searches messages by keywords, sender, time, mention, and more. |
+| `send_message` | Sends a message to a conversation. Supports replying to a specific thread. |
+
+## Get conversationId and threadId
+
+- **conversationId**: the space resource name, shaped like `spaces/AAAAAAA`. Get it with `search_conversations`.
+- **threadId**: the thread resource name, shaped like `spaces/AAAAAAA/threads/BBBBBBB`. Get it from `thread.name` in `list_messages` results.

package/docs/vi/atlassian.md

@@ -0,0 +1,170 @@
+# Atlassian
+
+[English](../atlassian.md) | [Tiếng Việt](atlassian.md)
+
+Tích hợp Jira và Confluence qua Atlassian REST API.
+
+## Biến môi trường
+
+| Biến | Bắt buộc | Mô tả |
+|------|----------|-------|
+| `ATLASSIAN_HOST` | Có | URL tổ chức, ví dụ `https://yourcompany.atlassian.net` |
+| `ATLASSIAN_EMAIL` | Có | Email tài khoản Atlassian |
+| `ATLASSIAN_API_TOKEN` | Có | API token từ cài đặt tài khoản Atlassian |
+
+Service chỉ được bật khi **cả ba** biến trên có giá trị.
+
+### Lấy API token
+
+1. Vào [Atlassian API tokens](https://id.atlassian.com/manage-profile/security/api-tokens)
+2. Tạo token mới, sao chép giá trị
+3. Điền vào `.env`:
+   ```
+   ATLASSIAN_HOST=https://yourcompany.atlassian.net
+   ATLASSIAN_EMAIL=your@email.com
+   ATLASSIAN_API_TOKEN=ATATT3xxxxx
+   ```
+
+## Endpoint MCP
+
+```
+http://localhost:47001/mcp/atlassian
+```
+
+## Đăng ký với AI Agents
+
+**Claude Code** — `.claude/settings.local.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "url": "http://localhost:47001/mcp/atlassian"
+    }
+  }
+}
+```
+
+Hoặc đăng ký bằng command line:
+```bash
+claude mcp add --transport http atlassian http://localhost:47001/mcp/atlassian
+```
+
+**Codex** — `~/.codex/config.toml`
+```toml
+[mcp_servers.atlassian]
+url = "http://localhost:47001/mcp/atlassian"
+```
+
+Hoặc đăng ký bằng command line:
+```bash
+codex mcp add atlassian --url http://localhost:47001/mcp/atlassian
+```
+
+**GitHub Copilot / VS Code** — `.vscode/mcp.json`
+```json
+{
+  "servers": {
+    "atlassian": {
+      "type": "http",
+      "url": "http://localhost:47001/mcp/atlassian"
+    }
+  }
+}
+```
+
+**Cursor** — `.cursor/mcp.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "url": "http://localhost:47001/mcp/atlassian"
+    }
+  }
+}
+```
+
+**Windsurf** — `~/.codeium/windsurf/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "serverUrl": "http://localhost:47001/mcp/atlassian"
+    }
+  }
+}
+```
+
+**Antigravity** — `~/.gemini/config/mcp_config.json`
+```json
+{
+  "mcpServers": {
+    "atlassian": {
+      "serverUrl": "http://localhost:47001/mcp/atlassian"
+    }
+  }
+}
+```
+
+## Danh sách tools
+
+### Jira
+
+| Tool | Mô tả |
+|------|-------|
+| `getJiraIssue` | Lấy chi tiết issue theo ID hoặc key (ví dụ `PROJECT-123`) |
+| `searchJiraIssuesUsingJql` | Tìm kiếm issues bằng JQL |
+| `createJiraIssue` | Tạo issue mới trong một project |
+| `editJiraIssue` | Cập nhật summary, description, assignee, hoặc priority |
+| `transitionJiraIssue` | Chuyển trạng thái workflow (ví dụ sang "In Progress", "Done") |
+| `getTransitionsForJiraIssue` | Liệt kê các transitions khả dụng của một issue |
+| `addCommentToJiraIssue` | Đăng comment lên issue |
+| `addWorklogToJiraIssue` | Ghi nhận thời gian làm việc lên issue |
+| `getVisibleJiraProjects` | Liệt kê tất cả projects có quyền truy cập |
+| `getJiraProjectIssueTypesMetadata` | Liệt kê các loại issue trong một project |
+| `getJiraIssueTypeMetaWithFields` | Lấy metadata fields khi tạo issue theo loại cụ thể |
+| `getIssueLinkTypes` | Liệt kê các kiểu liên kết issue (blocks, duplicates, v.v.) |
+| `getJiraIssueRemoteIssueLinks` | Liệt kê các link ngoài gắn vào issue (ví dụ trang Confluence) |
+| `lookupJiraAccountId` | Tìm account ID của user theo tên hoặc email |
+
+### Confluence
+
+| Tool | Mô tả |
+|------|-------|
+| `getConfluencePage` | Lấy nội dung trang theo ID |
+| `getConfluencePageDescendants` | Liệt kê các trang con của một trang |
+| `getConfluencePageFooterComments` | Lấy footer comments của trang |
+| `getConfluencePageInlineComments` | Lấy inline comments gắn với đoạn text cụ thể |
+| `getConfluenceCommentChildren` | Xem các reply của một comment |
+| `getConfluenceSpaces` | Liệt kê tất cả spaces có quyền truy cập |
+| `getPagesInConfluenceSpace` | Liệt kê các trang trong một space |
+| `createConfluencePage` | Tạo trang mới trong một space |
+| `updateConfluencePage` | Cập nhật nội dung hoặc tiêu đề trang (cần số version hiện tại) |
+| `createConfluenceFooterComment` | Thêm footer comment hoặc reply vào trang |
+| `createConfluenceInlineComment` | Tạo inline comment gắn với đoạn text cụ thể |
+| `searchConfluenceUsingCql` | Tìm kiếm nội dung bằng CQL |
+
+## Ví dụ JQL thường dùng
+
+```
+# Issues đang làm trong sprint hiện tại
+project = PROJ AND sprint in openSprints() AND status = "In Progress"
+
+# Bugs chưa xử lý, ưu tiên cao
+project = PROJ AND issuetype = Bug AND priority in (High, Highest) AND status != Done
+
+# Issues được giao cho tôi
+assignee = currentUser() AND status != Done ORDER BY created DESC
+```
+
+## Ví dụ CQL thường dùng
+
+```
+# Tìm trang trong space theo tiêu đề
+space = "DEV" AND title ~ "API" AND type = page
+
+# Tìm nội dung được chỉnh sửa gần đây
+lastModified > now("-7d") ORDER BY lastModified DESC
+
+# Tìm trang của một người cụ thể
+creator = "user@email.com" AND type = page
+```