> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent-mintlify-f21cea86.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 集成

> 将 Arka 连接到任何 Model Context Protocol (MCP) 服务器 — stdio 或 HTTP — 列出工具、调用工具以及检查健康状况。

Arka 可以从终端连接到**任何 MCP 服务器** — 与 Cursor、Claude Desktop 和其他 AI 客户端所使用的 [Model Context Protocol](https://modelcontextprotocol.io) 相同。

配置位于 `~/.config/arka/mcp.json`，采用与 Cursor 兼容的 `mcpServers` 格式。

## 快速开始

```bash theme={null}
# List configured servers
arka mcp list

# Add a stdio MCP server (command + args)
arka mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /tmp

# Add an HTTP/SSE MCP server
arka mcp add signoz --url http://localhost:8000/mcp \
  --header SIGNOZ-API-KEY=$SIGNOZ_API_KEY

# List tools from a server
arka mcp tools signoz

# Call a tool
arka mcp call signoz signoz_ask --args '{"question":"error rate last hour"}'

# Check connection health
arka mcp status
```

来自 fish：

```fish theme={null}
arka mcp list
arka mcp status
arka mcp tools signoz
```

自然语言（智能体路由）：

```fish theme={null}
arka "list mcp servers"
arka "mcp status"
arka "list mcp tools from signoz"
```

## 配置格式

`~/.config/arka/mcp.json`：

```json theme={null}
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    },
    "signoz": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "SIGNOZ-API-KEY": "<your-api-key>"
      }
    }
  }
}
```

Stdio 服务器使用 `command` + `args`。远程服务器使用 `url` + 可选的 `headers`。可选的 `env` 值支持 `${env:VAR_NAME}` 替换。

## 传输方式

| 传输方式 | 配置 | 示例 |
| - | - | - |
| **stdio** | `command` + `args` | `npx -y @modelcontextprotocol/server-filesystem /tmp` |
| **HTTP/SSE** | `url` + `headers` | 位于 `http://localhost:8000/mcp` 的 SigNoz MCP |

Arka 为远程服务器复用现有的 HTTP MCP 客户端，并为 stdio 使用内置的按行分隔 JSON-RPC 客户端 — 无需额外依赖。

## 可选的 Python SDK

```bash theme={null}
pip install mcp
```

Arka 不安装 SDK 也能工作。如果安装了，Arka 会检测到（`arka mcp status` 会显示 `sdk on`）。

## SigNoz MCP

针对 SigNoz，Arka 还附带了带追踪的辅助功能（`arka signoz status`、目标自愈）。通用的 `arka mcp` 可与任何 MCP 服务器一起使用 — 不仅限于 SigNoz。

```bash theme={null}
arka mcp add signoz --url http://localhost:8000/mcp --header SIGNOZ-API-KEY=$SIGNOZ_API_KEY
arka mcp tools signoz
```

## 命令参考

| 命令 | 描述 |
| - | - |
| `arka mcp list` | 列出已配置的 MCP 服务器 |
| `arka mcp add <name> <command> [args...]` | 添加 stdio 服务器 |
| `arka mcp add <name> --url <url>` | 添加 HTTP/SSE 服务器 |
| `arka mcp add <name> --url <url> --header KEY=VAL` | 添加带认证头的 HTTP 服务器 |
| `arka mcp remove <name>` | 移除服务器 |
| `arka mcp tools <server>` | 列出服务器的工具 |
| `arka mcp call <server> <tool> [--args '{}']` | 调用工具 |
| `arka mcp status` | 所有服务器的连接健康状况 |
| `arka mcp serve` | 将 Arka 作为本地 stdio MCP 服务器启动 |
| `arka mcp install` | 打印与 Cursor/Claude 兼容的 `mcp.json` 片段 |
| `arka mcp doctor` | 验证本地 Arka MCP 服务器能否启动 |

<Note>
  MCP 工具调用会为每次调用打开一个新连接。对于高频使用，建议将服务器保持在本地（stdio）或低延迟 HTTP 端点上。
</Note>

## 将 Arka 作为 MCP 服务器

其他智能体（Cursor、Claude Desktop、OpenClaw、Codex 等）可以通过 MCP 调用 Arka 技能和内存 — 使用与 Arka 作为 MCP **客户端**时相同的 stdio 传输。

### 快速开始

```bash theme={null}
# Start the server (stdio — used by MCP clients automatically)
arka mcp serve

# Print config for Cursor or Claude Desktop
arka mcp install

# Add arka to ~/.config/arka/mcp.json and print snippet
arka mcp install --write-config

# Verify initialize + tools/list
arka mcp doctor
```

**Cursor** 的 `~/.cursor/mcp.json` 示例：

```json theme={null}
{
  "mcpServers": {
    "arka": {
      "command": "arka",
      "args": ["mcp", "serve"]
    }
  }
}
```

在 PATH 中没有 `arka` 的可编辑安装：

```json theme={null}
{
  "mcpServers": {
    "arka": {
      "command": "python",
      "args": ["-m", "arka", "mcp", "serve"]
    }
  }
}
```

运行 `arka mcp install` 以打印适合您机器的正确命令。

### 暴露的工具

| 工具 | 描述 |
| - | - |
| `arka_ask` | 向 Arka 提问（网页、内存、计算、天气、聊天） |
| `arka_remember` | 存储事实、笔记或频道回合 |
| `arka_recall` | 按目标召回统一内存 |
| `arka_skill` | 调用命名的 Arka 技能 |
| `arka_repo_map` | 仓库布局和 Python 符号 |
| `arka_heartbeat` | 智能体心跳 — ping、状态或最近活动历史 |
| `arka_sessions` | 频道会话 — 列出、状态、上下文、恢复、静默检查、推送、重置 |
| `arka_routines` | 计划例程 — 列出、添加、删除、启用或禁用 |
| `arka_session_memory` | OpenClaw Markdown 内存 — 追加、搜索、上下文、状态、清空 |
| `arka_subagent` | Hermes 子智能体委派 — 生成、列出、状态、恢复结果 |
| `arka_project_rules` | Cursor 风格项目规则 — AGENTS.md、CLAUDE.md、`.cursor/rules` |
| `arka_webhook` | Webhook 网关 — 状态或健康检查 |
| `arka_view_data` | 预览 CSV/TSV 表格为纯文本 |
| `arka_clipboard` | 剪贴板历史 — 列出、保存、获取或清空 |
| `arka_share` | 分享最近一次 LLM 回复（含模型、提供商、token、延迟与输出，支持 markdown 或 JSON） |
| `arka_remind` | 提醒 — 列出、添加或取消 |
| `arka_bookmarks` | 书签 — 列出、保存、搜索、获取或删除 |
| `arka_docker` | Docker — 健康、容器、镜像或日志 |
| `arka_jsonkit` | JSON — 校验、美化、压缩或按路径取值 |
| `arka_timekit` | 时间 — 当前时间、时区转换或相对偏移 |
| `arka_urlkit` | URL 工具 — 解析、规范化或 slugify |
| `arka_password` | 密码 — 生成一次性密码（不入库） |
| `arka_spotify` | Spotify — 搜索曲目（不播放） |
| `arka_textkit` | 文本工具 — UUID、哈希或 Base64 编解码 |
| `arka_calendar` | 日历 — 今日行程（macOS 日历） |
| `arka_platform` | 平台 — 查看或检测系统能力 |
| `arka_personalize` | 个性化 — 资料状态、技能推荐、快速开始 |
| `arka_persona` | 人设 — 列出或查看人设配置 |
| `arka_github` | GitHub — 解析仓库或获取近期动态 |
| `arka_price` | 比价 — 列出零售源或解析查询 |
| `arka_config` | 配置 — 列出文件/目录或显示路径（只读） |
| `arka_sports` | 体育 — 实时比分或联赛列表 |
| `arka_qr` | 二维码 — 将文本/URL 编码为 ASCII 图案 |
| `arka_currency` | 汇率换算 — 金额转换或自然语言查询 |
| `arka_disk` | 磁盘空间 — 用量摘要或分类占用 |
| `arka_repo_health` | 仓库健康 — 扫描或运行 lint/测试检查 |
| `arka_agent_hub` | Agent Hub — 状态、适配器、检测、诊断、列表、内存来源或从 IDE 导入内存 |
| `arka_team_run` | 运行智能体团队工作流 |

### Agent Hub

`agent_hub sync` 将 MCP 配置复制到中枢，并确保 **arka** 自服务器条目存在，以便其他启动智能体可以合并它：

```bash theme={null}
arka agent_hub sync
arka agent_hub adapters    # see which agent configs would gain hub servers
```

中枢环境变量（`ARKA_MCP_CONFIG`、`ARKA_HUB_DIR`）已在 [Agent Hub](/cn/guides/agent-hub) 中记录。

#### 通过 MCP 从 IDE 导入内存

`arka_agent_hub` 可列出并导入 Cursor、Codex、OpenClaw、Arka 会话笔记及中枢导出：

```bash theme={null}
arka mcp call arka arka_agent_hub --args '{"action":"memory_sources"}'
arka mcp call arka arka_agent_hub --args '{"action":"import_memory","source":"cursor"}'
arka mcp call arka arka_agent_hub --args '{"action":"import_memory","all":true}'
```

| `action` | 参数 | 返回 |
| - | - | - |
| `memory_sources` | — | 本地存在的 `{ id, name, ide, files, file_count }` 数组 |
| `import_memory` | `path` 或 `source` / `ide` / `agent` 或 `all: true` | `{ ok, facts_imported, notes_imported, imports, errors }` |

详见 [Agent Hub — 内存导入](/cn/guides/agent-hub#内存导入)。


## Related topics

- [AI 智能体指南 — 通过 MCP 使用 Arka](/cn/guides/ai-agents.md)
- [如何用 Arka 写代码](/cn/guides/code-with-arka.md)
- [Agent Hub](/cn/guides/agent-hub.md)
- [生成音乐](/cn/guides/generate-music.md)
- [集成](/cn/guides/integrations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.