在 Claude Code 里搭建MCP服務(wù)器:一帖專治走投無路的技術(shù)“玄學(xué)”
折騰了半天,我總算在 Claude Code 里把 MCP 服務(wù)器給跑通了,雖然我本人快被搞得沒啥求生欲了。譯者注: 我照著這個(gè)腳本,幾分鐘搞定,??
MCP 服務(wù)器是啥玩意兒?
你可以把它想成是給 Claude 裝上的機(jī)械手和機(jī)械腿,讓它能在你電腦里到處爬。說得實(shí)在點(diǎn):就是些擴(kuò)展插件,讓它能干點(diǎn)實(shí)事,而不是只會(huì)生成一堆你永遠(yuǎn)用不上的代碼。
工具集 (★ = 需要 API 密鑰)
?順序思維 (Sequential Thinking):幫 Claude 一步步解決問題
?文件系統(tǒng) (Filesystem):讓 Claude 能在你授權(quán)的文件夾里翻箱倒柜
?Playwright:現(xiàn)代化的跨瀏覽器自動(dòng)化工具
?Puppeteer:僅支持 Chrome(已棄用)
?網(wǎng)頁抓取 (Web Fetching):從網(wǎng)站上扒內(nèi)容
?瀏覽器工具 (Browser Tools)(與 Chrome 開發(fā)者工具集成):通過一個(gè) Chrome 擴(kuò)展來捕獲和分析瀏覽器數(shù)據(jù)
?★ Brave 搜索 (Brave Search):網(wǎng)頁搜索能力
?★ Firecrawl:高級網(wǎng)頁爬取
一鍵安裝(“老子沒空”版)
把下面代碼塊里的所有東西一字不差地復(fù)制,粘貼到 macOS/Linux 終端里,然后敲回車 ?。
bash <<'EOF'
echo "?? 正在安裝 Claude MCP 服務(wù)器(最新版)…"
# 順序思維 — Claude 的“思考鏈”引擎
claude mcp add sequential-thinking -s user \
-- npx -y @modelcontextprotocol/server-sequential-thinking || true
# 文件系統(tǒng) — 賦予 Claude 訪問本地文件夾的權(quán)限
claude mcp add filesystem -s user \
-- npx -y @modelcontextprotocol/server-filesystem \
~/Documents ~/Desktop ~/Downloads ~/Projects || true
# Playwright — 現(xiàn)代化的跨瀏覽器自動(dòng)化工具
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
# 瀏覽器工具 — 開發(fā)者工具的日志、截圖等
claude mcp add browser-tools -s user \
-- npx -y @agentdeskai/browser-tools-mcp || true
echo "--------------------------------------------------"
echo "? MCP 注冊完成。"
echo ""
echo "?? 要啟用“瀏覽器工具”,請?jiān)?另一個(gè)*終端里運(yùn)行以下命令,并保持該窗口開啟:"
echo " npx -y @agentdeskai/browser-tools-server"
echo "--------------------------------------------------"
claude mcp list
EOF把這段代碼保存成 install-mcp-servers.sh,給它加上執(zhí)行權(quán)限 (chmod +x install-mcp-servers.sh),然后在懷疑人生的同時(shí)運(yùn)行它。
Windows 用戶:你們得自己搞個(gè) .bat 批處理文件。祝你們好運(yùn)!
核心 MCP 服務(wù)器(逐個(gè)安裝)
順序思維 (Sequential Thinking)
claude mcp add sequential-thinking -s user \
-- npx -y @modelcontextprotocol/server-sequential-thinking讓 Claude 能真正地去思考問題,而不是一本正經(jīng)地胡說八道。
文件系統(tǒng)訪問 (Filesystem Access) (按需修改路徑)
claude mcp add filesystem -s user \
-- npx -y @modelcontextprotocol/server-filesystem \
~/Documents ~/Desktop ~/Downloads ~/Projects讓 Claude 能訪問你的文件。
Playwright (跨瀏覽器自動(dòng)化)
claude mcp add playwright -s user \
-- npx -y @playwright/mcpPuppeteer (已棄用,但還能用)
claude mcp add puppeteer -s user \
-- npx -y @modelcontextprotocol/server-puppeteer眼睜睜看著你的瀏覽器自己動(dòng)起來,感受那份存在主義的恐懼吧。
網(wǎng)頁抓取 (Web Fetching)
claude mcp add fetch -s user \
-- npx -y @kazuph/mcp-fetch從網(wǎng)站上扒內(nèi)容。
瀏覽器工具 (Browser Tools)
讓 Claude 能訪問你瀏覽器的控制臺(tái)日志、網(wǎng)絡(luò)流量,并能運(yùn)行性能/無障礙審計(jì)。
第 1 步: 安裝 Chrome 擴(kuò)展 – 從 releases 頁面下載,然后通過 Chrome 的擴(kuò)展程序管理器加載它。
第 2 步: 啟動(dòng)中間件服務(wù)器(保持這個(gè)終端窗口開啟)
npx -y @agentdeskai/browser-tools-server@1.2.1第 3 步: 把 MCP 服務(wù)器添加到 Claude Code (在另一個(gè)終端里操作)
claude mcp add browser-tools -s user \
-- npx -y @agentdeskai/browser-tools-mcp@1.2.1第 4 步: 打開 Chrome 開發(fā)者工具 (F12),找到 BrowserTools 標(biāo)簽頁。
★ 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 能上網(wǎng)搜索并帶回結(jié)果。
★ Firecrawl (高級網(wǎng)頁爬取 — 需要 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當(dāng)你需要以工業(yè)級的效率、并對 robots.txt 文件致以最少的敬意去爬取網(wǎng)站時(shí),就用它。
關(guān)于 -s user 和 -s local 的那點(diǎn)事兒
?-s user: 讓這些工具全局可用
?-s local: 只在當(dāng)前目錄下生效
疑難解答
?Windows 問題:在 npx 命令前加上cmd /c
?超時(shí)錯(cuò)誤:MCP_TIMEOUT=10000 claude
?連接問題:在 Claude Code 里輸入/mcp,看看是哪個(gè)服務(wù)器在打瞌睡
?文件系統(tǒng)訪問:再三檢查你的路徑設(shè)置
就這么多。希望能幫你省下我那逝去的四個(gè)小時(shí)生命。
又及——沒錯(cuò),這篇東西大部分是靠 Claude 寫的。
某人的使用心得
結(jié)果我發(fā)現(xiàn),給Claude準(zhǔn)備一套能交叉引用的輔助說明文檔,讓它自己鉆進(jìn)去研究,差不多就能自動(dòng)優(yōu)化它的推理能力,前提是這些文檔里的指令都各司其職、范圍明確、目的清晰。很多人都在說給Claude一個(gè)markdown文件讓它照著干,但你可以把這個(gè)想法放大三倍:準(zhǔn)備一個(gè)負(fù)責(zé)宏觀大局的readme,一個(gè)高度優(yōu)化、分工明確、專門指示“照這個(gè)精確執(zhí)行,但具體細(xì)節(jié)去查閱某某文件”的行動(dòng)指南,還有一個(gè)介于兩者之間、承上啟下的readme。這些文件共同勾勒出了一幅完整的藍(lán)圖,填補(bǔ)了Claude在推理時(shí)對上下文背景的感知空白,并且通過明確“該想什么”和“不該想什么”的界限,進(jìn)一步防止了意外跑偏。
當(dāng)然,前提是你的這些readme文件都優(yōu)化得很好(這事兒挺花時(shí)間的):
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).翻譯過來如下:
“首先,把整個(gè)提示詞給我通讀一遍,每個(gè)細(xì)節(jié)都要吃透。運(yùn)用順序思維,在 optimized-segments.md 文件里,找到優(yōu)先級最高的一個(gè)任務(wù)模塊來執(zhí)行。然后,將這個(gè)選定模塊的指令與 Master Checklist.md 和 Master Codebase.md 文件里的相關(guān)文檔進(jìn)行交叉比對,確保 optimized-segments.md 里的指令是合理且有效的。接著,再次運(yùn)用順序思維,按照指令對代碼庫進(jìn)行必要且全面的修改。在修改代碼和文件的整個(gè)過程中——無論是之前、之中還是之后——你都必須遵循 optimized-segments.md 里的指令,嚴(yán)格遵守它的規(guī)范、格式和精度要求——然后,更新 optimized-segments.md、Master Checklist.md 和 Master Codebase.md 這幾個(gè)文件里相應(yīng)板塊的狀態(tài)。(注意保持簡潔,別寫廢話,并且確保你只用編輯功能修改這些重要文件的相關(guān)部分,絕對不要整個(gè)文件重新寫一遍)?!?/code>只要這些文件結(jié)構(gòu)清晰,最后的效果就是,你可以在代碼庫文件更新之后,直接開一個(gè)新的聊天窗口,把同樣的提示詞再扔給它,因?yàn)樗鼌⒖嫉哪切﹔eadme文件也已經(jīng)被同步更新了。
我就是靠著反復(fù)用這個(gè)提示詞,硬生生寫完了一整個(gè)App。但這里面所有的功夫其實(shí)都花在了搭建、優(yōu)化、更新、再優(yōu)化那些readme文件上。這整個(gè)過程需要對現(xiàn)有代碼庫進(jìn)行大量的順序思考、交叉分析、代碼審計(jì)、文檔審查等等。
原文:https://www.reddit.com/r/ClaudeAI/comments/1jf4hnt/setting_up_mcp_servers_in_claude_code_a_tech/
本文轉(zhuǎn)載自??alitrack ??,作者: alitrack

















