用了大半年AI编程工具，说句实话：光靠Claude Code或Cursor本身，干不了太多事。它们能写代码、能找Bug，但碰到"帮我查下数据库""把这个页面爬下来""看看GitHub上那个Issue"这类需求，直接就卡住了。

解决办法就是MCP（Model Context Protocol）。简单说，MCP就是给AI工具装外挂的标准接口。装好MCP Server之后，Claude Code可以直接连你的数据库、爬网页、操作GitHub，不用你来回复制粘贴。

这篇记录我实际在用的5个MCP Server，怎么配、踩过什么坑、哪些值得装。

先搞清楚MCP的基本结构

MCP基于JSON-RPC 2.0协议，分三个角色：

• Host：你的AI工具本身（Claude Code、Cursor、VS Code）
• Client：工具内部负责和Server通信的模块
• Server：提供具体能力的程序（爬网页、查数据库等）

传输方式有两种：stdio（本地运行）和HTTP/SSE（远程连接）。大部分开发场景用stdio就够了。

配置文件的位置因工具而异：

通用格式长这样：

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "package-name"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

搞清楚这些再往下看。

1. Firecrawl：爬网页内容

场景：让AI读取某个网页的内容，比如"帮我看看这篇文档说了什么"或者"把竞品的功能页抓下来分析"。

Firecrawl把网页转成干净的文本，去掉导航栏、广告、脚本标签这些噪音。GitHub上11万星，MCP生态里用得最多的Server之一。

配置：

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-your-key-here"
      }
    }
  }
}

API Key去 firecrawl.dev 注册拿，免费额度每月500次请求，个人开发够用。

踩坑记录： - npx首次运行会下载依赖，Claude Code里可能等30秒才有响应，别以为挂了 - 爬动态渲染页面（React/Vue单页应用）时，默认模式可能拿到空内容，需要加waitFor参数 - 免费额度用完不会报明确错误，只返回空结果，排查了好一会才发现是额度问题 - 某些网站有反爬策略，Firecrawl会被拦截返回403，换个User-Agent或者用headless模式能解决

实际用法：在Claude Code里直接说"用firecrawl抓取 https://xxx.com 的内容"，它会自动调用。

2. GitHub MCP：直接操作仓库

写代码离不开GitHub。没装这个之前，查Issue、看PR、读某个文件，都得自己打开浏览器找好了再贴给AI。装了之后，直接说"看看这个仓库最近的Issue有哪些"就行。

配置（用GitHub官方的MCP Server）：

# Claude Code 用命令行添加
claude mcp add github -- npx -y @modelcontextprotocol/server-github

# 需要设置 GitHub Token
export GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxx

或者写进配置文件：

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

Token权限建议只开repo和read:org，别给太大权限。

踩坑记录： - Token权限不够时，报错信息含糊，只说"request failed"，不告诉你是权限问题 - 处理大仓库（文件超过1000个）时，列文件目录会很慢，建议指定具体路径 - 私有仓库确保Token有对应的repo访问权限，这点容易忘

3. PostgreSQL MCP：连数据库查数据

后端开发最常见的需求：让AI帮你写SQL、查数据、分析表结构。不装这个的话，你得自己跑SQL、把结果贴给AI、再让它分析——来回三趟。装了之后一句话搞定。

配置：

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

踩坑记录： - 生产库千万别直接连。我的做法是连只读副本，或者本地开发库 - 连接字符串里的密码如果有特殊字符（@、#），需要URL编码，不然连不上 - 表多的库（几百张表），AI列schema会消耗大量token，建议对话时指定具体的表名

实际场景：我调试一个Bug时让Claude Code直接查了数据库里的异常记录，从发现问题到定位原因，5分钟搞定。以前至少要20分钟。

4. Filesystem MCP：读写本地文件

"这不是废话吗？Claude Code本来就能读文件。"

不完全对。Claude Code确实能读项目目录的文件，但有限制——它只能访问你启动时所在的目录。如果你想让它读另一个目录的配置文件、日志文件，或者写入特定位置，Filesystem MCP更灵活。

配置：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y", "@modelcontextprotocol/server-filesystem",
        "/Users/me/projects",
        "/Users/me/logs"
      ]
    }
  }
}

args里列出允许访问的目录，没列出的目录AI访问不了，这是安全设计。

踩坑记录： - 目录路径必须是绝对路径，用~或相对路径都不行 - 写文件操作默认是开放的，如果你只想让AI读不想让它改，目前没有只读模式，需要自己注意 - macOS上如果目录在iCloud同步范围内，写入时偶尔会冲突

5. Brave Search MCP：让AI能搜索

写代码时经常需要搜索："这个报错怎么解决""这个库的最新版本是什么""有没有类似的开源方案"。装了搜索MCP之后，AI可以自己去搜，不用你来回切浏览器。

配置：

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

Brave Search API免费额度每月2000次查询，注册地址 brave.com/search/api。

踩坑记录： - 搜索结果是摘要文本，不是完整网页。想看完整内容还得配合Firecrawl用 - 中文搜索质量一般，英文搜索明显更好

组合用法：5个Server一起干活

单个MCP Server有用，但组合起来才真的强。举个实际例子：

需求："帮我调研一下市面上的表单构建工具，看看哪个适合我们项目。"

AI的工作流程：

1. 用Brave Search搜索"open source form builder 2026"
2. 用Firecrawl爬取搜索结果中几个候选工具的文档页
3. 用GitHub MCP查看它们的仓库活跃度（Star数、最近提交、Issue数量）
4. 用PostgreSQL查我们现有表单模块的表结构做对比
5. 用Filesystem把调研结果写入本地文档

整个过程你只需要说一句话，中间不用干预。

安全提醒

MCP给了AI真实的操作权限，安全问题别忽略。API Key和数据库密码放环境变量，别写死在配置文件然后提交到Git。GitHub Token只给最小必要权限。数据库只连开发库或只读副本，这个是底线。

总结

这5个MCP Server覆盖了日常开发最常见的场景：爬网页、操作GitHub、查数据库、读写文件、搜索信息。配一次，之后每天都在用。

配置不复杂，主要是踩坑。特殊字符编码、权限设置、首次下载等待，这些琐碎问题花的时间比配置本身还多。这篇把我踩过的坑都列了。

没装过MCP Server的话，建议从Firecrawl和GitHub这两个开始，装完当天就能感受到区别。