MCP 工具

Moltbot 开箱即用时已经具备聊天、记忆和问答能力。如果需要更多功能——搜索网页、操作浏览器、执行定时任务——则需要接入外部工具。

这里的「工具」基于 MCP（Model Context Protocol）协议。MCP 是 Anthropic 推出的开放协议，允许 AI 安全地调用外部能力。你不需要了解协议细节，掌握配置方法即可。

一个关键概念

Moltbot 本身不是 MCP server。为其添加 MCP 工具需要使用 mcporter 这个技能（skill）。

Moltbot 是 MCP 的消费者，不是提供者。它通过 mcporter 连接各种 MCP server，调用这些 server 提供的工具。

内置工具

在配置任何 MCP 之前，Moltbot 已自带以下工具：

browser — 打开和读取网页内容。无需额外配置。告诉 Moltbot「帮我看看这个链接里写了什么」，它会使用 browser 工具抓取页面内容。

canvas — 生成和编辑可视化内容。例如生成图表或 HTML 预览。

nodes — 执行计算逻辑。Moltbot 在需要进行复杂计算时会调用。

cron — 定时任务相关，详见定时任务。

sessions — 管理对话会话。

这些内置工具开箱即用，无需任何配置。

网页搜索

这是使用频率很高的功能，让 Moltbot 能够搜索互联网。

使用的是 Brave Search API。选择 Brave 的原因是它提供免费额度：每月 2000 次免费查询，对个人用户足够。

配置步骤

1. 前往 brave.com/search/api 注册账号
2. 创建一个 API Key
3. 配置到 Moltbot 中

moltbot configure --section web

按提示填入 API Key。

或使用环境变量：

export BRAVE_SEARCH_API_KEY=BSAxxxxxxxxxxxxxxxxxxxxxxxx

配置完成后即可使用：

搜一下最近的 Node.js 22 有什么新特性

帮我查查杭州明天的天气

Moltbot 会通过 Brave Search 搜索并将结果整理后返回。

2000 次够用吗

通常足够。并非每次对话都会触发搜索，只有 Moltbot 判断需要联网查询时才会调用。

如果用量较大，Brave Search 提供付费计划，每月几美元即可获得更高额度。

用 mcporter 添加 MCP 工具

要接入更多 MCP server，使用 mcporter。

直接告诉 Moltbot：

帮我安装 GitHub MCP server

或者：

我想让你能操作我的 GitHub 仓库

Moltbot 会调用 mcporter 技能引导你完成配置，包括提供必要信息（如 GitHub Token），并将 MCP server 配置写入配置文件。

如果偏好手动配置，可以直接编辑配置文件：

# ~/.moltbot/config.yaml
mcp:
  servers:
    github:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-github"]
      env:
        GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxxxxxxxxxxx"

    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]

每个 MCP server 是一个独立进程。Moltbot 启动时会将配置中列出的 server 全部拉起。

推荐的 MCP Server

GitHub — 管理仓库、查看 PR、创建 Issue。对开发者来说几乎是必备的。

文件系统 — 让 Moltbot 读写本地文件。可以限制为只能访问特定目录，提升安全性。

SQLite / PostgreSQL — 让 Moltbot 查询数据库。做数据分析时非常有用，可以用自然语言提问，如「上个月销售额最高的产品是什么」，Moltbot 会自动生成并执行 SQL 查询。

Puppeteer — 浏览器自动化。比内置的 browser 工具更强大，支持模拟点击、填写表单和截图。

这些 MCP server 都是开源的，可在 npm 上找到。

工具安全

接入工具时需要注意权限控制。

GitHub Token 的权限应尽量精简。如果只需要查看 Issue 和 PR，不要赋予仓库写权限。

文件系统工具务必限制可访问目录，不要开放整个 home 目录。

更多安全建议参见安全配置。

调试 MCP 连接

工具无法正常工作时，查看日志：

moltbot start --verbose

常见问题：

npx 报错找不到包？ — 检查 Node.js 版本，MCP server 通常需要 Node 18+

连接超时？ — 部分 MCP server 启动较慢，稍等后重试

权限不足？ — 检查 Token 或 API Key 的权限设置

工具调用了但无效果？ — 查看 MCP server 的日志输出，部分 server 将日志输出到 stderr