convez.ai
MCP ServerIntegração & APIsIntermediário
dengye2026

Hermes MCP Server

dengye2026/hermes-mcp-server

13 ferramentas para potencializar seus editores de IA com Web Search, File I/O e Shell Execution

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP com 13 ferramentas prontas para uso em editores de IA (Claude Code, Cursor, Windsurf, Continue.dev). Oferece busca web, leitura/escrita de arquivos, execução de shell, processamento JSON e utilitários de cálculo — com versão gratuita básica e recursos avançados por pequeno investimento único.

Instalação

$npx convez-ai dengye2026/hermes-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Buscar informações em tempo real durante desenvolvimento
  • Ler e manipular arquivos do projeto dentro do editor de IA
  • Executar comandos shell sem sair do ambiente de codificação
  • Validar e processar JSON em larga escala
  • Gerar UUIDs, timestamps, hashes e codificações base64

Veredito

MCP server robusto e bem documentado que estende significativamente as capacidades de editores de IA com funcionalidades críticas. Modelo freemium sensato (ferramentas básicas gratuitas, recursos avançados por investimento único), embora o README em chinês limita a acessibilidade para audiência brasileira.

README

A tradução para o português deste README ainda está na fila.

🚀 Hermes MCP Server

全能 MCP Server — 为 AI 编程工具提供 13 个开箱即用的能力

让你的 Claude Code、Cursor、Windsurf、Continue.dev 瞬间拥有 Web 搜索、文件读写、JSON 处理、Shell 执行等强大功能。


🎬 效果预览

┌──────────────────────────────────────────────────────────────┐
│  🤖 Claude Code: "搜索最新的 Rust 语言新闻"                    │
│  ──────────────────────────────────────────────────────────── │
│  🔍 web_search(query="Rust programming language 2025 news")  │
│                                                              │
│  1. Rust 1.85 正式发布 — 新特性详解                          │
│     https://blog.rust-lang.org/...                           │
│     带来了更快的编译速度和更好的异步支持...                   │
│                                                              │
│  💻 无需离开编辑器,直接获取全网信息!                        │
└──────────────────────────────────────────────────────────────┘

(效果图为 ASCII 示意,实际使用中直接在你的 AI 编辑器内完成)


✨ 功能概览

分类工具说明价格
🆓 免费calc数学计算(安全沙箱)免费
🆓 免费timestamp当前时间(支持时区)免费
🆓 免费uuid生成 UUID v4免费
🆓 免费hash哈希计算(md5/sha256/sha512)免费
🆓 免费base64Base64 编码/解码免费
💎 Proweb_search🌐 搜索引擎(DuckDuckGo)¥29 永久
💎 Proweb_fetch🌐 抓取网页内容¥29 永久
💎 Proread_file📄 读取文件(支持行号)¥29 永久
💎 Prowrite_file✏️ 写入文件(自动创建目录)¥29 永久
💎 Proexec_command💻 执行 Shell 命令¥29 永久
💎 Projson_process🔧 JSON 校验/格式化/路径查询¥29 永久
💎 Prolist_dir📁 列出目录(支持深度)¥29 永久
💎 Proenv_infoℹ️ 环境信息查看¥29 永久

Pro 版仅需 ¥29 — 永久授权,一次购买终身使用!


📥 安装方法

方法一:npm 全局安装(推荐)

# 全局安装
npm install -g hermes-mcp-server

# 验证安装
hermes-mcp --version

方法二:npx 直接运行(无需安装)

# 无需安装,直接运行
npx hermes-mcp-server

方法三:从源码构建

git clone https://github.com/dengye2026/hermes-mcp-server.git
cd hermes-mcp-server
npm install
npm run build
npm start

🔧 配置指南

配置 Claude Code

在 ~/.claude/mcp.json 中添加:

{
  "mcpServers": {
    "hermes": {
      "command": "npx",
      "args": ["-y", "hermes-mcp-server"]
    }
  }
}

或使用全局安装后的路径:

{
  "mcpServers": {
    "hermes": {
      "command": "hermes-mcp"
    }
  }
}

配置 Cursor

在 Cursor 中打开设置 → Features → MCP Servers → Add Server:

  • Name: hermes
  • Type: command
  • Command: npx -y hermes-mcp-server

或者编辑 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "hermes": {
      "command": "npx",
      "args": ["-y", "hermes-mcp-server"]
    }
  }
}

配置 Windsurf

在 ~/.codeium/windsurf/mcp_config.json 中添加:

{
  "mcpServers": {
    "hermes": {
      "command": "npx",
      "args": ["-y", "hermes-mcp-server"]
    }
  }
}

配置 Continue.dev

在 ~/.continue/config.json 中添加 experimental.mcpServers:

{
  "experimental": {
    "mcpServers": {
      "hermes": {
        "command": "npx",
        "args": ["-y", "hermes-mcp-server"]
      }
    }
  }
}

🚀 快速开始

1. 安装后验证

运行以下命令确认服务启动成功:

npx hermes-mcp-server

正常输出(启动后等待 MCP 协议握手):

Hermes MCP Server v0.1.0 已启动

2. 在 Claude Code 中测试

启动 Claude Code 后,尝试以下命令:

@hermes 搜索一下最近 TypeScript 的新特性
@hermes 帮我计算 2^16 + sqrt(144)
@hermes 现在北京时间是多少?

3. Pro 用户激活

购买授权 Key 后,将其写入配置文件:

mkdir -p ~/.hermes-mcp
echo "YOUR_LICENSE_KEY" > ~/.hermes-mcp/license.key

或通过环境变量激活:

export HERMES_MCP_TIER=pro

💰 购买 Pro 版

Pro 版解锁全部 13 个工具(免费版仅 5 个),仅需 ¥29 永久授权!

购买方式

  1. 支付宝扫码付款 ¥29
  2. 截图发给卖家,获取授权 Key
  3. 写入授权 Key 即可永久使用

付款后

将付款截图和你的「邮箱/微信」发送给卖家,你将收到:

  • 唯一的 授权 Key
  • Pro 版使用说明
  • 技术支持

常见问题

Q: 授权是永久的吗? A: 是的!¥29 一次性付费,永久使用 Pro 版所有功能。

Q: 可以在多台电脑上使用吗? A: 一个授权 Key 限一台设备。如需多台使用,请分别购买。

Q: 支持退款吗? A: 数字商品,一经售出概不退款。购买前请确认功能满足需求。


❓ 常见问题(FAQ)

1. 什么是 MCP Server?

MCP(Model Context Protocol)是 Anthropic 推出的 AI 工具协议。MCP Server 可以为 AI 编程助手(如 Claude Code、Cursor)提供额外的能力,比如搜索网页、读写文件等。

2. 免费版和 Pro 版有什么区别?

特性免费版Pro 版
calc 计算器✅✅
timestamp 时间✅✅
uuid UUID✅✅
hash 哈希✅✅
base64 编码✅✅
web_search 搜索❌✅
web_fetch 抓取❌✅
read_file 读文件❌✅
write_file 写文件❌✅
exec_command 执行命令❌✅
json_process JSON 处理❌✅
list_dir 列目录❌✅
env_info 环境信息❌✅
价格免费¥29 永久

3. 是否支持 TypeScript?

Hermes MCP Server 本身就是用 TypeScript 编写的。源码完全开源,你可以 fork 并扩展自己的工具。

4. 可以在 Cursor 中使用吗?

当然!Cursor 完全支持 MCP 协议。参考上方的 配置 Cursor 部分即可。

5. 支持哪些搜索引擎?

当前使用 DuckDuckGo 作为搜索引擎,无需 API Key,完全免费。未来版本计划支持 Google Custom Search 和 Bing Search。

6. 如何升级 Pro 版?

购买授权 Key 后,运行:

mkdir -p ~/.hermes-mcp
echo "你的授权Key" > ~/.hermes-mcp/license.key

重新启动 Claude Code / Cursor 即可生效。

7. 如何获得技术支持?

直接联系作者 dengye(微信/邮件:dengye@mcpkit.cn),或访问 https://mcpkit.cn

8. 是否开源?

是的!源码在 GitHub 上开源:https://github.com/dengye2026/hermes-mcp-server


🛠️ 工具参考

免费工具

calc — 数学计算器

  • 说明: 安全沙箱中执行数学运算
  • 参数: expression(字符串,数学表达式)
  • 支持: +, -, *, /, **, %, sqrt(), abs(), round(), floor(), ceil(), sin(), cos(), tan(), log(), ln(), pi, e, pow(), max(), min()
  • 示例: calc("2**16 + sqrt(144)") → 65536 + 12 = 65548

timestamp — 当前时间

  • 说明: 获取当前时间,支持自定义时区
  • 参数: timezone(可选,如 "Asia/Shanghai", "America/New_York")
  • 示例: timestamp("Asia/Shanghai") → 2025-06-16 14:30:00 (CST)

uuid — 生成 UUID

  • 说明: 生成 UUID v4 随机标识符
  • 参数: 无
  • 示例: uuid() → 550e8400-e29b-41d4-a716-446655440000

hash — 哈希计算

  • 说明: 对文本进行哈希计算
  • 参数: text(待哈希文本), algorithm(md5/sha256/sha512)
  • 示例: hash("hello", "sha256") → 2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824

base64 — Base64 编解码

  • 说明: 对文本进行 Base64 编码或解码
  • 参数: text(待处理文本), mode(encode/decode)
  • 示例: base64("Hello World", "encode") → SGVsbG8gV29ybGQ=

Pro 工具

web_search — 网页搜索 🌐

  • 说明: 通过 DuckDuckGo 搜索网页,返回标题、URL、摘要
  • 参数: query(搜索关键词), limit(结果数 1-20,默认 5)
  • 示例: web_search("2025 AI trends", 5)

web_fetch — 网页抓取 🌐

  • 说明: 抓取指定 URL 的文本内容(自动去除 HTML 标签)
  • 参数: url(完整 URL), maxChars(最大字符数 100-100000,默认 20000)
  • 示例: web_fetch("https://example.com", 5000)

read_file — 读取文件 📄

  • 说明: 读取本地文件,支持行号和偏移
  • 参数: path(绝对路径), offset(起始行,默认 1), limit(最大行数,默认 200)
  • 示例: read_file("/home/user/project/src/main.ts", 1, 50)

write_file — 写入文件 ✏️

  • 说明: 写入文件,自动创建父目录
  • 参数: path(绝对路径), content(文件内容)
  • 示例: write_file("/home/user/test.txt", "Hello World")

exec_command — 执行命令 💻

  • 说明: 执行 Shell 命令,返回 stdout/stderr
  • 参数: command(命令), timeout(超时 ms,默认 30000), workdir(工作目录,可选)
  • 示例: exec_command("ls -la", 10000, "/home/user")

json_process — JSON 处理 🔧

  • 说明: 校验、格式化、路径查询 JSON 数据
  • 参数: json(JSON 字符串), mode(validate/format/query), path(查询路径,如 "data.items[0].name")
  • 示例: json_process('{"a":1,"b":2}', "format")

list_dir — 列出目录 📁

  • 说明: 递归列出目录内容
  • 参数: path(目录路径), depth(递归深度,默认 1,最大 3)
  • 示例: list_dir("/home/user/project", 2)

env_info — 环境信息 ℹ️

  • 说明: 查看操作系统、Node.js 版本、CPU 架构等环境信息
  • 参数: 无
  • 示例: env_info() → 显示系统信息

💻 开发指南

环境要求

  • Node.js ≥ 18.0.0
  • npm ≥ 9.0.0

克隆与构建

# 克隆仓库
git clone https://github.com/dengye2026/hermes-mcp-server.git
cd hermes-mcp-server

# 安装依赖
npm install

# 构建
npm run build

# 开发模式(热重载)
npm run dev

# 运行
npm start

项目结构

hermes-mcp-server/
├── src/
│   ├── index.ts          # 主入口 — 工具注册
│   └── license.ts        # 授权验证
├── bin/
│   └── hermes-mcp        # CLI 入口脚本
├── dist/                 # 构建输出
├── scripts/
│   ├── install.sh        # 一键安装脚本
│   └── manage-keys.js    # 授权 Key 管理
├── package.json
├── tsconfig.json
└── README.md

运行测试

# 快速测试启动
node test-fast.js

# 完整测试
node test.js

管理员命令

node scripts/manage-keys.js generate [买家] [备注]    # 生成新 Key
node scripts/manage-keys.js list                     # 列出所有 Key
node scripts/manage-keys.js validate <key>           # 验证 Key
node scripts/manage-keys.js revoke <key>             # 吊销 Key

📄 协议信息

  • MCP 协议版本: 2025-11-25
  • 传输方式: stdio
  • 开源协议: MIT

👨‍💻 作者 & 联系


Ver o original no GitHub

Bom para

Relacionados