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`,覆盖了日常开发和内容创作的大部分场景。
                                                          
                                                          有其他国内可用的好工具欢迎评论区补充。
相关推荐
Android出海4 小时前
2026主流AI工具对比:ChatGPT、Gemini、Claude、Grok深度分析与选择
人工智能·ai·chatgpt·claude·grok·ai工具·gemini
Soari18 小时前
【稳定性增强】Claude Code v2.1.140:优化 /goal 异常处理,解决后台服务连接问题
claude
AI_paid_community20 小时前
25k Star 登顶 GitHub:这个专门吃 K 线图长大的 AI,让我意识到之前三年都在裸奔
javascript·claude
HLAIA光子21 小时前
Claude Code、Codex 为什么都选了 Grep 而不是 RAG
ai编程·claude
Dvesiz1 天前
【ClaudeCode平替(免费)】OpenCode 完整安装与 VSCode 使用指南
ide·vscode·编辑器·github·ai编程·claude·visual studio code
YoungHong19921 天前
Pi Coding Agent : AI时代的“VSCode“
ide·人工智能·gpt·claude·claudecode
闵孚龙1 天前
Claude Code 缓存架构与断点设计全解析:Prompt Cache、上下文工程、Token 成本优化、AI Agent 长会话性能治理
人工智能·缓存·架构·prompt·claude
花椰菜菜1 天前
Claude Code 产品负责人 Kat Wu 的深度访谈,AI 时代的进化方法论
claude
十八旬2 天前
快速安装ClaudeCode完整指南
开发语言·windows·python·claude