MCP(Model Context Protocol)火了将近一年,awesome-mcp-servers 在 GitHub 上已经 50k+ star,各种工具层出不穷。但网上的配置教程几乎全是英文视角:Brave Search、Linear、Notion......这些工具要么国内访问有问题,要么根本不在我们的使用场景里。
这篇是我自己在国内网络环境下踩坑整理出来的配置,按实用频率排序,全部亲测可用。
基础层:所有人必装
filesystem + fetch + memory + git
这四个是地基,跳过讲细节,只说一个容易踩的坑:
fetch 用 uvx 不用 npx:
json
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}
```
uvx 是 Python 生态,不需要 Node 环境,国内下载速度远比 npx 稳。如果 uvx 慢,先设镜像:
```bash
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
```
---
## 开发者层
### GitHub MCP(官方出品)
PR 管理、Issues 操作、代码搜索,直接让 Claude 干,不用手写 gh 命令。
```json
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token"
}
}
```
Token 在 GitHub Settings → Developer settings → Personal access tokens 生成,勾上 repo 权限即可。
### Playwright(微软出品)
浏览器自动化,截图、表单、数据抓取。比 Puppeteer 更稳,国内能跑。
```json
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
```
### SQLite
本地数据库直接让 Claude 查,分析数据神器。
```json
"sqlite": {
"command": "uvx",
"args": ["mcp-server-sqlite", "--db-path", "/path/to/your.db"]
}
```
---
## 中国用户专属层(英文教程没有的)
### china-hot-mcp --- 实时热搜
让 Claude 拿到微博、知乎、B站、百度、抖音、36氪的实时热搜数据。
做内容的人需求最强:以前每天手动刷五个 App 找热点,现在直接问 Claude「今天有什么值得写的热点话题」,它自己拉数据分析。
特别的地方是双数据源设计------优先直连平台接口,失败了走备用聚合源,比单一数据源的同类工具稳定。
```bash
pip install china-hot-mcp
```
```json
"china-hot": {
"command": "china-hot-mcp"
}
```
纯 Python,不依赖 Node,国内网络下比 npx 系工具省心。
项目地址:https://github.com/EA-Studio-SHARK/china-hot-mcp
### 高德地图 MCP
路线规划、POI 搜索、实时路况、天气查询。国内地图需求就用这个,不用再绕 Google Maps。
---
## 搜索层:Brave Search 的国内替代
Brave Search 需要国外账号,大部分人用不了。替代方案是 **Tavily**:
```json
"tavily": {
"command": "npx",
"args": ["-y", "tavily-mcp"],
"env": {
"TAVILY_API_KEY": "your_key"
}
}
```
Tavily 国内可访问,免费版每月 1000 次调用,专为 AI 检索优化,效果比通用搜索好。官网注册:tavily.com
---
## 踩坑记录
**npx 超时**
```bash
npm config set registry https://registry.npmmirror.com
```
**Claude Desktop 配置后工具不出现**
1. 检查 JSON 格式(括号、逗号,JSON 不支持注释)
2. 完全退出再重启(不是刷新)
3. 看 Console 日志:Mac 下 `~/Library/Logs/Claude/`
**uvx 找不到命令**
```bash
pip install uv
```
uv 是 Astral 出的 Python 包管理器,安装后就有 uvx。
---
## 配置参考资源
有个 GitHub 项目专门收录国内网络环境下亲测可用的 MCP 服务,配置有完整示例,还有踩坑记录,比直接看英文 awesome-mcp-servers 实用:
👉 https://github.com/EA-Studio-SHARK/awesome-mcp-zh
---
目前我自己稳定在用的组合:`filesystem + fetch + memory + github + playwright + china-hot-mcp + tavily`,覆盖了日常开发和内容创作的大部分场景。
有其他国内可用的好工具欢迎评论区补充。