内容
# 🔌 Hermes MCP 服务器
> **将 100 多种 Hermes Agent 技能暴露给任何与 MCP 兼容的 AI 客户端。**
>
> 将 Claude Desktop、Cursor、Continue、Zed 或任何 MCP 客户端连接到 Hermes Agent 的强大工具包。
[](https://pypi.org/project/hermes-mcp-server/)
[](LICENSE)
[](https://github.com/sponsors/pangtongya)
[](https://modelcontextprotocol.io)
---
## ✨ 您将获得
安装一个 MCP 服务器，即可获得 AI 客户端中的所有这些工具：
| 类别 | 工具 |
|----------|-------|
| 🌐 **网页** | 搜索，提取，导航，抓取 |
| 🖥️ **浏览器** | 完整的无头浏览器 — 点击，输入，滚动，截图 |
| 💻 **终端** | 执行 shell 命令，运行 Python 代码 |
| 📁 **文件** | 读取，写入，搜索文件（支持 ripgrep） |
| 🐙 **GitHub** | 仓库信息，搜索，创建问题，管理拉取请求 |
| 📚 **研究** | arXiv 搜索，YouTube 转录，博客监控 |
| 📝 **生产力** | Notion，Google Workspace，Linear，Airtable |
| 🎨 **创意** | 图片生成，ASCII 艺术，图表，音乐 |
| 🤖 **AI** | 完整的 Hermes Agent 推理 — 多步骤，使用工具 |
---
## 🚀 快速开始
### 1. 安装
```bash
pip install hermes-mcp-server
```
### 2. 启动 Hermes Agent
```bash
# 启动 Hermes Agent 并启用 HTTP API
hermes serve --http --port 8080
```
### 3. 配置您的 MCP 客户端
**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"hermes": {
"command": "hermes-mcp",
"args": ["--endpoint", "http://localhost:8080"],
"env": {
"HERMES_API_KEY": "your-api-key-here"
}
}
}
}
```
**Cursor / Continue / Zed**:
```json
{
"mcpServers": {
"hermes": {
"command": "hermes-mcp",
"args": ["--endpoint", "https://your-hermes-instance.com"]
}
}
}
```
### 4. 重启您的 MCP 客户端并开始使用 Hermes 工具！
---
## 📋 完整工具列表
| 工具 | 描述 |
|------|-------------|
| `web_search` | Google/Bing 网页搜索，附带摘要 |
| `web_extract` | 从任意 URL 提取干净的内容 |
| `browser_navigate` | 无头浏览器导航 |
| `browser_snapshot` | 获取页面可访问性树 |
| `browser_click` | 按参考 ID 点击元素 |
| `terminal_exec` | 执行 shell 命令 |
| `code_execute` | 使用 Hermes SDK 运行 Python 代码 |
| `file_read` | 读取带有行号的文件 |
| `file_write` | 创建/覆盖文件 |
| `file_search` | 支持 ripgrep 的文件/内容搜索 |
| `github_repo_info` | 获取 GitHub 仓库详细信息 |
| `github_search_repos` | 搜索 GitHub 仓库 |
| `github_create_issue` | 创建 GitHub 问题 |
| `arxiv_search` | 搜索学术论文 |
| `youtube_transcript` | 获取 YouTube 转录 |
| `notion_search` | 搜索 Notion 工作区 |
| `image_generate` | AI 图片生成 |
| `ai_complete` | 完整的 Hermes Agent 推理 |
> 80 多种工具即将到来 — 所有 100 多种 Hermes 技能都将被暴露。
---
## 🐳 Docker
```bash
docker run -e HERMES_ENDPOINT=http://host.docker.internal:8080 \
ghcr.io/pangtongya/hermes-mcp-server:latest
```
---
## 💰 货币化
Hermes MCP 服务器是 **免费且开源** 的。收入来自：
| 层级 | 价格 | 包含内容 |
|------|-------|----------|
| 🆓 **社区** | 免费 | 自托管，所有工具，社区支持 |
| ⭐ **专业** | $5/月 | 优先支持，托管 Hermes 端点，1000 请求/天 |
| 🏢 **团队** | $29/月 | 5 个席位，托管端点，10000 请求/天，Slack 支持 |
| 🚀 **企业** | 自定义 | 专用实例，SSO，SLA，无限请求 |
**[成为赞助者 →](https://github.com/sponsors/pangtongya)**
---
## 🏗️ 架构
```
┌──────────────────┐ MCP 协议 ┌──────────────────┐ HTTP ┌──────────────────┐
│ Claude Desktop │◄────────────────────►│ Hermes MCP │◄────────────►│ Hermes Agent │
│ Cursor / Zed │ （stdio / JSON-RPC） │ 服务器 │ （REST API） │ 100+ 技能 │
│ Continue / etc │ │ （Python） │ │ 工具 + 模型 │
└──────────────────┘ └──────────────────┘ └──────────────────┘
```
---
## 🔧 配置
| 环境变量 | 默认值 | 描述 |
|---------------------|---------|-------------|
| `HERMES_ENDPOINT` | `http://localhost:8080` | Hermes Agent HTTP 端点 |
| `HERMES_API_KEY` | （无） | 身份验证 API 密钥 |
---
## 🛠️ 开发
```bash
git clone https://github.com/pangtongya/hermes-mcp-server.git
cd hermes-mcp-server
pip install -e ".[dev]"
# 运行测试
pytest
# 本地运行
python -m hermes_mcp.cli --endpoint http://localhost:8080
```
---
## 📄 许可证
MIT © [pangtongya](https://github.com/pangtongya)
---
## ⭐ 星级历史
如果这个项目对您有帮助，请考虑 [赞助](https://github.com/sponsors/pangtongya) 或给予它一个 ⭐！
