毓惶博客

本文是 Hermes Agent 教学系列 第 07 篇。让 agent 能访问 Notion / Gmail / GitHub / 你自己的服务。

MCP 一句话讲清楚

MCP(Model Context Protocol)是 Anthropic 2024 年提出的一个开放协议,解决一个问题:LLM 怎么跟外部工具/服务/数据说话。

类比 USB-C。以前每个 agent 都要为每个服务写专门的集成,现在大家都接 MCP,插一个 server 用一个。

举个例子:

你想让 Hermes 读/写 Notion 页面

Notion 官方提供了 MCP server(https://mcp.notion.com/mcp)

你告诉 Hermes 这个 server 在哪,Hermes 就获得了「读写 Notion」的一整套工具(search、fetch、create-page 等等)

现在主流的应用几乎都在推 MCP server,包括 Notion、Slack、GitHub、Linear、Asana、Google Drive、Gmail、Figma 等等。

Hermes 怎么接 MCP

方式 1:CLI 一句话添加

会出交互式向导:

认证方式:Notion 走 OAuth,Hermes 会弹出浏览器让你授权

服务名:默认 notion,之后在 CLI 里调用会看到 notion__search 这样的工具名

启用? 是

方式 2:手动编辑配置文件

三种传输方式:

url —— 远程 HTTP MCP server(大多数云服务)

stdio —— 本地进程通过标准输入输出(本地工具、自写 server)

sse —— Server-Sent Events,跨于 URL 与 stdio 之间

验证 MCP 在跑

看到连接的服务列表,状态应该是 connected。运行有问题 /mcp logs <name> 查看详细错误。

试一下:

Hermes 会调用 notion__search 工具,返回你的页面。

常用 MCP server 推荐

给你一个快速起点:

Server	能做什么	URL
Notion	读写页面、查询数据库	https://mcp.notion.com/mcp
GitHub	issue、PR、代码搜索	https://api.githubcopilot.com/mcp
Slack	读发消息	官方推出中,社区版可用
Google Drive	文件读取、搜索	https://drivemcp.googleapis.com/mcp/v1
Gmail	邮件读发	社区 server,多个选择
Linear	issue 管理	https://mcp.linear.app/sse
Filesystem	本地文件访问	npm 安装,stdio 运行
Browser	控制本地浏览器	npm 安装,stdio

社区目录:mcp.so 或 glama.ai/mcp/servers。

自己写一个 MCP server

场景:你有个公司内部 API,希望 Hermes 能调。

最简单的 Python 示例:

添加到 Hermes:

重启 Hermes,它现在会 internal__get_inventory(sku="...") 了。

skill 与 MCP 合作

上篇说过两者区别,这里说起作用。你可以写一个专为某个 MCP 服务设计的 skill:

这样下次你说「帮我发表这篇为草稿」,Hermes 直接走这个流程,不需要跟它说明数据库名、字段、默认状态。

调试与问题排查

MCP 连不上是最常见问题,几个排查思路:

hermes mcp test <name> —— 测连接与认证

鉴权失效 —— OAuth token 到期,重跑 hermes mcp reauth <name>

stdio server 不启动 —— 手动运行 command 看详细报错,多数是 Python/Node 环境问题

工具名冲突 —— 两个 server 提供同名工具时,Hermes 会加前缀,你可以调整 server 名避开

权限边界

MCP server 可能拿到你账号里的东西。几个原则:

优先用官方 server(比如 mcp.notion.com),不随便装社区未核实的

能 OAuth 不用 long-lived token。OAuth token 可以随时在服务控制台撤销

带写权限的 server 设个贴身小黑服默认——hermes mcp permissions <name> --require-approval write,写操作必需你点头

公司资产谨慎——在个人 Hermes 上接公司的 GitHub / Slack 要考虑合规

到这一篇为止 Hermes 已经能说话、能记事、能学招式、能接外部工具。但它还在被动等你发指令。

下一篇让它主动起来:定时任务与自动化。「每周一早上 9 点把 Slack 未读重点发我邮箱」这种话,跟它说一句,他设一生。

本系列文章持续更新,下篇见。

Menu