2026年中国开发者MCP实战配置指南:亲测可用,附踩坑记录

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`,覆盖了日常开发和内容创作的大部分场景。
                                                          
                                                          有其他国内可用的好工具欢迎评论区补充。
相关推荐
黎羽_21 小时前
Claude 免费号 7 天养号毕业全记录:54 轮对话、IP 预检与月度维护
claude·免费账号·muse·ai 养号
ZzT21 小时前
AI-SDLC 实践 06|开发阶段的知识库:Agent 写代码前该读哪些规则和业务知识
ai编程·claude
小七-七牛开发者2 天前
Anthropic:Agent 不必一直运行,也能持续工作
agent·claude·deepseek·anthropic·alwaysonagent
孟健3 天前
用T3 Code手机远程控制Claude Code完成周报总结实测
开源·ai编程·claude
武子康3 天前
H3-World 动作控制怎么测:从左右对照到片内切换
人工智能·agent·claude
小七-七牛开发者3 天前
PACE:代码通过率从 42% 到 97%, 让长程 Agent 在有限 KV Cache 下用好历史 Token
大模型·claude·token·工作流·长程agent
ZzT3 天前
沙箱不再自动放行、项目配置默认禁用:Claude Code 与 Codex 升级适配指南
ai编程·claude
ZhengEnCi4 天前
AI 规则越多越费 Token:无关规则让每次回答多耗 46% 的规则体检提示词
aigc·ai编程·claude
ServBay4 天前
连AI自己也不愿意维护自己的屎山代码
后端·ai编程·claude
jerrywus4 天前
用 AMD Radeon Cloud 免费跑 ComfyUI:从开机到打开界面
前端·agent·claude