很多人装了 Claude Code 或 Hermes Agent 后只会聊天——其实 MCP（Model Context Protocol）才是让 Agent 从「嘴炮」变「实干」的关键。本文给出5个核心 MCP Server 的完整接入配置，复制粘贴就能用。

为什么你的 Agent 只能「看」不能「动」

最近和几个在做 AI 编程助手的创业者聊，发现一个共同痛点：

「Claude Code 很聪明，但它只能读我的代码、给建议。我想让它直接帮我操作 GitHub、查数据库、跑测试——但它说它做不到。」

这不是 Claude Code 的错。AI Agent 的「手」是 MCP Server。

简单理解：

没有 MCP	有 MCP
Agent 只能读取项目文件	Agent 能操作 GitHub、数据库、浏览器
每次手动复制粘贴上下文	Agent 自主搜索文档、查 API
「帮我修这个 bug」→ 给建议	「帮我修这个 bug」→ 读代码→查文档→改代码→提 PR
像一个聪明的实习生	像一个全栈工程师

MCP（Model Context Protocol）是 Anthropic 在 2024 年底发布的开放协议。到 2026 年 6 月，生态里已经有 200+ 个 MCP Server，覆盖 GitHub、PostgreSQL、文件系统、网页搜索、浏览器自动化等几乎所有开发场景。

下面5个是我在多个项目中验证过的「必装」级 MCP Server，每个都附完整接入配置。

MCP Server 1：Filesystem — 让 Agent 真正读写文件

安装原因：大部分 AI 编程工具默认只能读当前项目目录。有了 filesystem MCP Server，Agent 可以读写任意路径——配置文件、日志、数据文件、系统文件都不在话下。

配置（Claude Code）

在 ~/.claude/claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic/mcp-server-filesystem",
        "/home/user/projects",
        "/home/user/documents",
        "/tmp"
      ]
    }
  }
}

⚠️ 安全提醒：只开放你需要 Agent 访问的目录，不要给根目录 / 权限。

配置（Hermes Agent）

在 Hermes 的配置文件（通常是 ~/.hermes/config.yaml 或项目根目录的 .hermes/config.yaml）中加入：

mcp_servers:
  filesystem:
    command: "npx"
    args:
      - "-y"
      - "@anthropic/mcp-server-filesystem"
      - "/home/user/projects"

实测场景

你：帮我把 /tmp 下所有超过 100MB 的日志文件列出来，并压缩
Agent：[调用 filesystem MCP] 
      → 列出 /tmp 文件及大小
      → 筛选 >100MB 的文件
      → 逐个 gzip 压缩
      → 报告：已压缩 3 个文件，节省 1.2GB

MCP Server 2：GitHub — Agent 直接操作仓库

安装原因：这是最实用的 MCP Server 之一。Agent 可以直接创建 Issue、提 PR、管理分支、搜索代码——不需要你手动在 GitHub 网页上操作。

前置准备

生成 GitHub Personal Access Token：Settings → Developer settings → Personal access tokens → Fine-grained tokens
权限勾选：Contents (Read/Write)、Pull requests (Read/Write)、Issues (Read/Write)

配置

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    }
  }
}

实测场景

你：把我们项目的 README.md 和 docs/ 下的内容对比，标注过时部分，然后创建 Issue

Agent：[调用 github MCP]
      → 读取仓库 README.md
      → 遍历 docs/ 目录所有 .md 文件
      → 对比 API 端点、版本号、配置示例
      → 发现 3 处过时内容
      → 创建 GitHub Issue #247：「文档过时 - README vs docs/ 不一致」

真实数据：我们团队用这个配置后，文档 PR 从平均 3 天缩短到 2 小时。

MCP Server 3：Brave Search — Agent 能自己上网查

安装原因：Agent 写代码时经常需要查最新 API 文档、Stack Overflow 方案、或某个库的版本更新。Brave Search MCP 让 Agent 直接搜索网页。

前置准备

注册 Brave Search API：https://api.search.brave.com/
免费层每月 2000 次查询（个人够用）
获取 API Key

配置

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "BSA_xxxxxxxxxxxx"
      }
    }
  }
}

实测场景

你：帮我把这个项目的依赖升级到最新版本，但要排除有 breaking change 的

Agent：[调用 brave-search MCP]
      → 搜 "react 19 breaking changes 2026"
      → 搜 "next.js 16 migration guide"
      → 搜 "typescript 6.0 deprecated features"
      → 汇总结论：react 可从 18→19（无 breaking change for us）
      → next.js 14→16 需修改 middleware 写法
      → 只升级安全补丁，标记 next.js 待人工确认

MCP Server 4：PostgreSQL — Agent 直接查数据库

安装原因：后端开发中最常见的场景——Agent 需要查数据库结构、验证数据、跑查询。有了 PostgreSQL MCP Server，Agent 不需要你手动导出 SQL 文件给它看。

配置

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/mydb"
      }
    }
  }
}

安全建议：创建只读数据库用户给 Agent 使用，避免误操作：

CREATE USER agent_readonly WITH PASSWORD 'secure_pass';
GRANT CONNECT ON DATABASE mydb TO agent_readonly;
GRANT USAGE ON SCHEMA public TO agent_readonly;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO agent_readonly;

实测场景

你：用户反馈订单查询变慢了，帮我分析

Agent：[调用 postgres MCP]
      → EXPLAIN ANALYZE 慢查询
      → 发现 orders 表缺少 user_id 索引
      → 建议：CREATE INDEX idx_orders_user_id ON orders(user_id)
      → 预估效果：查询从 2.3s 降到 12ms
      → 你确认后，Agent 直接执行 DDL 并验证

MCP Server 5：Puppeteer — Agent 能操作浏览器

安装原因：这是最被低估的 MCP Server。有了 Puppeteer，Agent 可以：
- 截图验证前端页面
- 自动填表测试
- 抓取需要 JS 渲染的网页
- 做端到端测试

配置

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-puppeteer"]
    }
  }
}

需要系统已安装 Chrome/Chromium。Ubuntu/Debian：apt install chromium-browser

实测场景

你：我刚改了登录页面，帮我验证一下在各种情况下是否正常

Agent：[调用 puppeteer MCP]
      → 打开登录页 → 截图
      → 输入空用户名 → 提交 → 验证错误提示出现
      → 输入错误密码 → 提交 → 验证错误提示
      → 输入正确凭证 → 提交 → 验证跳转到首页
      → 报告：3 个测试用例，3 个通过，无异常
      → 附上每个步骤的截图

一键配置模板

把上面5个 MCP Server 合并到一个配置文件中，直接可用：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/home/YOUR_USER/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_YOUR_TOKEN" }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-brave-search"],
      "env": { "BRAVE_API_KEY": "BSA_YOUR_KEY" }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-postgres"],
      "env": { "DATABASE_URL": "postgresql://user:pass@localhost:5432/db" }
    },
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-puppeteer"]
    }
  }
}

保存到 ~/.claude/claude_desktop_config.json（Claude Code）或对应的 Hermes 配置文件，重启 Agent 即可使用。

常见问题

Q1：MCP Server 会消耗额外 Token 吗？

会的。每次 MCP 工具调用都会将结果返回给模型，计入上下文。但收益远超成本——实测用 GitHub MCP 创建 Issue 消耗约 800 tokens（$0.012），但省去你 5 分钟手动操作。

Q2：配置后 Agent 会自己乱操作吗？

默认不会。Claude Code 和 Hermes Agent 在执行破坏性操作前都会请求确认（需要你输入 "yes"）。你可以在配置中设置 autoApprove 白名单来跳过某些安全操作的确认。

Q3：除了这5个，还有什么值得装的？

Sequential Thinking：让 Agent 一步步推理复杂问题
Memory：持久化知识图谱，跨会话记忆
Docker：Agent 直接管理容器
Slack：Agent 发消息到团队频道

MCP 生态发展极快，建议关注 https://github.com/modelcontextprotocol/servers 获取最新列表。

Q4：Hermes Agent 和 Claude Code 的 MCP 配置一样吗？

协议层面完全一样（都是 MCP）。配置文件格式可能略有不同：
- Claude Code：claude_desktop_config.json（JSON 格式）
- Hermes Agent：config.yaml 或 config.json（同时支持 YAML 和 JSON）

具体路径查看各自文档：hermes config --path 或查看 ~/.hermes/ 目录。

行动建议

今天就装 Filesystem + GitHub（最基础，零门槛）
三天内加上 Brave Search（Agent 能自己查资料是质变）
根据你的技术栈选装（PostgreSQL 给后端、Puppeteer 给前端）
观察一周 Agent 行为，调整 autoApprove 白名单

AI 创业者最大的护城河不是模型本身，而是把 Agent 接入真实工作流的能力。MCP 就是这座桥。

AI创业 #MCP #Agent工坊 #ClaudeCode #一人公司