在 Claude Code 里搭建MCP服务器:一帖专治走投无路的技术“玄学”

发布于 2025-9-9 07:19
浏览
0收藏

折腾了半天,我总算在 Claude Code 里把 MCP 服务器给跑通了,虽然我本人快被搞得没啥求生欲了。译者注: 我照着这个脚本,几分钟搞定,✌️

MCP 服务器是啥玩意儿?

你可以把它想成是给 Claude 装上的机械手和机械腿,让它能在你电脑里到处爬。说得实在点:就是些扩展插件,让它能干点实事,而不是只会生成一堆你永远用不上的代码。

工具集 (★ = 需要 API 密钥)

•顺序思维 (Sequential Thinking):帮 Claude 一步步解决问题

•文件系统 (Filesystem):让 Claude 能在你授权的文件夹里翻箱倒柜

•Playwright:现代化的跨浏览器自动化工具

•Puppeteer:仅支持 Chrome(已弃用)

•网页抓取 (Web Fetching):从网站上扒内容

•浏览器工具 (Browser Tools)(与 Chrome 开发者工具集成):通过一个 Chrome 扩展来捕获和分析浏览器数据

•★ Brave 搜索 (Brave Search):网页搜索能力

•★ Firecrawl:高级网页爬取

一键安装(“老子没空”版)

把下面代码块里的所有东西一字不差地复制,粘贴到 macOS/Linux 终端里,然后敲回车 ↵。

bash <<'EOF'
echo "🔧  正在安装 Claude MCP 服务器(最新版)…"

# 顺序思维 — Claude 的“思考链”引擎
claude mcp add sequential-thinking -s user \
  -- npx -y @modelcontextprotocol/server-sequential-thinking || true

# 文件系统 — 赋予 Claude 访问本地文件夹的权限
claude mcp add filesystem -s user \
  -- npx -y @modelcontextprotocol/server-filesystem \
     ~/Documents ~/Desktop ~/Downloads ~/Projects || true

# Playwright — 现代化的跨浏览器自动化工具
claude mcp add playwright -s user \
  -- npx -y @playwright/mcp-server || true

# Puppeteer — 仅支持 Chrome(已弃用,但还能用)
claude mcp add puppeteer -s user \
  -- npx -y @modelcontextprotocol/server-puppeteer || true

# Fetch — 简单的 HTTP GET/POST
claude mcp add fetch -s user \
  -- npx -y @kazuph/mcp-fetch || true

# 浏览器工具 — 开发者工具的日志、截图等
claude mcp add browser-tools -s user \
  -- npx -y @agentdeskai/browser-tools-mcp || true

echo "--------------------------------------------------"
echo "✅  MCP 注册完成。"
echo ""
echo "🔴  要启用“浏览器工具”,请在*另一个*终端里运行以下命令,并保持该窗口开启:"
echo "    npx -y @agentdeskai/browser-tools-server"
echo "--------------------------------------------------"
claude mcp list
EOF

把这段代码保存成 install-mcp-servers.sh,给它加上执行权限 (chmod +x install-mcp-servers.sh),然后在怀疑人生的同时运行它。

Windows 用户:你们得自己搞个 .bat 批处理文件。祝你们好运!

核心 MCP 服务器(逐个安装)

顺序思维 (Sequential Thinking)

claude mcp add sequential-thinking -s user \
  -- npx -y @modelcontextprotocol/server-sequential-thinking

让 Claude 能真正地去思考问题,而不是一本正经地胡说八道。

文件系统访问 (Filesystem Access) (按需修改路径)

claude mcp add filesystem -s user \
  -- npx -y @modelcontextprotocol/server-filesystem \
     ~/Documents ~/Desktop ~/Downloads ~/Projects

让 Claude 能访问你的文件。

Playwright (跨浏览器自动化)

claude mcp add playwright -s user \
  -- npx -y @playwright/mcp

Puppeteer (已弃用,但还能用)

claude mcp add puppeteer -s user \
  -- npx -y @modelcontextprotocol/server-puppeteer

眼睁睁看着你的浏览器自己动起来,感受那份存在主义的恐惧吧。

网页抓取 (Web Fetching)

claude mcp add fetch -s user \
  -- npx -y @kazuph/mcp-fetch

从网站上扒内容。

浏览器工具 (Browser Tools)

让 Claude 能访问你浏览器的控制台日志、网络流量,并能运行性能/无障碍审计。

第 1 步: 安装 Chrome 扩展 – 从 releases 页面下载,然后通过 Chrome 的扩展程序管理器加载它。

第 2 步: 启动中间件服务器(保持这个终端窗口开启)

npx -y @agentdeskai/browser-tools-server@1.2.1

第 3 步: 把 MCP 服务器添加到 Claude Code (在另一个终端里操作)

claude mcp add browser-tools -s user \
  -- npx -y @agentdeskai/browser-tools-mcp@1.2.1

第 4 步: 打开 Chrome 开发者工具 (F12),找到 BrowserTools 标签页。

★ Brave 搜索 (Brave Search) (需要 API 密钥)

# 把 YOUR_API_KEY_HERE 换成你自己的 Brave Search API 密钥
claude mcp add brave-search -s user \
  -- env BRAVE_API_KEY=YOUR_API_KEY_HERE \
     npx -y @modelcontextprotocol/server-brave-search

让 Claude 能上网搜索并带回结果。

★ Firecrawl (高级网页爬取 — 需要 API 密钥)

# 把 fc-YOUR_API_KEY 换成你自己的 Firecrawl API 密钥
claude mcp add firecrawl -s user \
  -- env FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
     npx -y firecrawl-mcp

当你需要以工业级的效率、并对 robots.txt 文件致以最少的敬意去爬取网站时,就用它。

关于 -s user 和 -s local 的那点事儿

•-s user: 让这些工具全局可用

•-s local: 只在当前目录下生效

疑难解答

•Windows 问题:在 npx 命令前加上cmd /c

•超时错误:MCP_TIMEOUT=10000 claude

•连接问题:在 Claude Code 里输入/mcp,看看是哪个服务器在打瞌睡

•文件系统访问:再三检查你的路径设置

就这么多。希望能帮你省下我那逝去的四个小时生命。

又及——没错,这篇东西大部分是靠 Claude 写的。

某人的使用心得

结果我发现,给Claude准备一套能交叉引用的辅助说明文档,让它自己钻进去研究,差不多就能自动优化它的推理能力,前提是这些文档里的指令都各司其职、范围明确、目的清晰。很多人都在说给Claude一个markdown文件让它照着干,但你可以把这个想法放大三倍:准备一个负责宏观大局的readme,一个高度优化、分工明确、专门指示“照这个精确执行,但具体细节去查阅某某文件”的行动指南,还有一个介于两者之间、承上启下的readme。这些文件共同勾勒出了一幅完整的蓝图,填补了Claude在推理时对上下文背景的感知空白,并且通过明确“该想什么”和“不该想什么”的界限,进一步防止了意外跑偏。

当然,前提是你的这些readme文件都优化得很好(这事儿挺花时间的):

FIRSTLY, READ THROUGH THIS PROMPT THOROUGHLY. UNDERSTAND ALL ASPECTS. Using sequentialthinking, find ONE segment ranked with the highest priority to take action upon within the optimized-segments.md and cross reference the chosen segments to work on from the Segment's directive against its correlate documentation within Master Checklist and the Master Codebase files to ensure your directive within the optimized-segments.md is sound and valid. Then use sequentialthinking to push the necessary, comprehensive changes as directed to the codebase. Before, during, and after codefix and file changes you will follow the directives of the optimized-segments.md respecting its guidelines and formatting and precision -- and then UPDATE THE STATUSES to the appropriate SECTION(s) of the optimized-segments.md Master Checklist.md and the Master Codebase.md (keep concise and bloat free, and ensure your updates to these highly important documents are only to relevant sections using edit_file functionality and not complete re-writes).

翻译过来如下:

“首先,把整个提示词给我通读一遍,每个细节都要吃透。运用顺序思维,在 optimized-segments.md 文件里,找到优先级最高的一个任务模块来执行。然后,将这个选定模块的指令与 Master Checklist.md 和 Master Codebase.md 文件里的相关文档进行交叉比对,确保 optimized-segments.md 里的指令是合理且有效的。接着,再次运用顺序思维,按照指令对代码库进行必要且全面的修改。在修改代码和文件的整个过程中——无论是之前、之中还是之后——你都必须遵循 optimized-segments.md 里的指令,严格遵守它的规范、格式和精度要求——然后,更新 optimized-segments.md、Master Checklist.md 和 Master Codebase.md 这几个文件里相应板块的状态。(注意保持简洁,别写废话,并且确保你只用编辑功能修改这些重要文件的相关部分,绝对不要整个文件重新写一遍)。“

只要这些文件结构清晰,最后的效果就是,你可以在代码库文件更新之后,直接开一个新的聊天窗口,把同样的提示词再扔给它,因为它参考的那些readme文件也已经被同步更新了。

我就是靠着反复用这个提示词,硬生生写完了一整个App。但这里面所有的功夫其实都花在了搭建、优化、更新、再优化那些readme文件上。这整个过程需要对现有代码库进行大量的顺序思考、交叉分析、代码审计、文档审查等等。

原文:https://www.reddit.com/r/ClaudeAI/comments/1jf4hnt/setting_up_mcp_servers_in_claude_code_a_tech/

本文转载自alitrack  ,作者: alitrack

已于2025-9-9 10:20:30修改
收藏
回复
举报
回复
相关推荐