在Claude Code設(shè)置MCP服務(wù)器
一、什么是 MCP 服務(wù)器?
- MCP(Model Context Protocol) 是一種讓 Claude 獲得“外部能力”的機制。
- 它相當(dāng)于 Claude 的“數(shù)字假肢”,賦予它訪問文件系統(tǒng)、瀏覽器、網(wǎng)頁抓取、搜索等功能。
- 常見 MCP 工具:
| 工具 | 功能 | 是否需 API Key |
|---|---|---|
| Sequential Thinking | 鏈?zhǔn)酵评恚瑴p少幻覺 | 否 |
| Filesystem | 訪問本地目錄 | 否 |
| Playwright | 多瀏覽器自動化 | 否 |
| Puppeteer | Chrome 自動化(已棄用) | 否 |
| Fetch | HTTP 請求 / 抓取網(wǎng)頁 | 否 |
| Browser Tools | DevTools 控制 / 截圖 / 日志 | 否 |
| Brave Search | 網(wǎng)絡(luò)搜索能力 | ? |
| Firecrawl | 高級網(wǎng)頁抓取 | ? |
# 基本 MCP 服務(wù)器 (單獨安裝)
順序思考
claude mcp add sequential-thinking -s user \ -- npx -y @modelcontextprotocol/server-sequential-thinking
讓 Claude 真正思考問題,而不是自信地胡編亂造。
文件系統(tǒng)訪問(根據(jù)需要更新路徑)
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(Web 獲取)
claude mcp add fetch -s user \ -- npx -y @kazuph/mcp-fetch
從網(wǎng)站抓取內(nèi)容。
瀏覽器工具
讓 Claude 訪問你瀏覽器的控制臺日志、網(wǎng)絡(luò)流量,并能夠運行性能/可訪問性審核。
步驟 1:安裝 Chrome 擴(kuò)展程序 — 從發(fā)布頁面下載并將其加載到 Chrome 的擴(kuò)展管理器中。
步驟 2:啟動中間件服務(wù)器(保持此終端打開):
npx -y @agentdeskai/browser-tools-server@1.2.1
步驟 3:將 MCP 服務(wù)器添加到 Claude Code(在單獨的終端中):
claude mcp add browser-tools -s user \ -- npx -y @agentdeskai/browser-tools-mcp@1.2.1
步驟 4:打開 Chrome DevTools (F12) 并找到 BrowserTools 標(biāo)簽。
★ 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)絡(luò)并帶回結(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è)級效率抓取網(wǎng)站,并且對 robots.txt 沒啥敬意的時候。
二、一鍵安裝腳本(macOS / Linux)
可批量安裝多個常用 MCP 工具:
bash <<'EOF'
echo " 正在安裝 Claude MCP 服務(wù)器..."
claude mcp add sequential-thinking -s user \
-- npx -y @modelcontextprotocol/server-sequential-thinking || true
claude mcp add filesystem -s user \
-- npx -y @modelcontextprotocol/server-filesystem \
~/Documents ~/Desktop ~/Downloads ~/Projects || true
claude mcp add playwright -s user \
-- npx -y @playwright/mcp-server || true
claude mcp add puppeteer -s user \
-- npx -y @modelcontextprotocol/server-puppeteer || true
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
?? Windows 用戶:可將上述命令改寫為 .bat 文件或在命令前加上 cmd /c。
三、安裝范圍說明
| 參數(shù) | 含義 | 配置文件位置 |
|---|---|---|
| -s user | 全局安裝 | ~/.claude.json |
| -s local | 項目內(nèi)安裝 | 當(dāng)前項目目錄下的 .claude.json |
macOS 特殊說明:
- Claude Desktop 配置文件:
~/Library/Application Support/Claude/claude_desktop_config.json - Claude Code 配置文件:
~/.claude.json - 兩者的 MCP 配置是分開的。
四、常見問題與解決方案
| 問題 | 可能原因 | 解決方式 |
|---|---|---|
| MCP 顯示連接但無響應(yīng) | 路徑配置或通信異常 | 檢查 claude mcp list 輸出和日志 |
| 超時錯誤 | 執(zhí)行時間過短 | 設(shè)置環(huán)境變量:export MCP_TIMEOUT=10000 |
| Windows 命令執(zhí)行失敗 | CMD 兼容問題 | 在命令前添加 cmd /c |
| Docker/WSL 無法通信 | 網(wǎng)絡(luò)隔離 | 使用 host.docker.internal 作為主機地址 |
| Puppeteer 失效 | 工具已棄用 | 推薦改用 Playwright MCP |
示例 .claude.json 配置:
"mcpServers": {
"browser-tools": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agentdeskai/browser-tools-mcp@1.2.0"
],
"env": {
"BROWSERTOOLS_SERVER_HOST": "host.docker.internal",
"BROWSERTOOLS_SERVER_PORT": "3025"
}
}
}五、提示工程建議(Prompt Engineering)
Claude 可能不會主動使用 MCP 工具,需在提示中顯式說明使用哪個 MCP。
作者推薦的做法:
- 將項目說明拆分為多層 README(如主層、模塊層、任務(wù)層)。
- 通過結(jié)構(gòu)化提示,讓 Claude 依據(jù)層級調(diào)用相應(yīng) MCP。
此方式能減少 Claude 誤調(diào)用、提升推理一致性。
六、總結(jié)與建議
MCP 是讓 Claude Code 擁有“外部能力”的核心機制。
通過腳本可快速啟用常用工具,增強 Claude 的實用性。
注意區(qū)分:
- 全局 vs 局部配置;
- 不同系統(tǒng)路徑差異;
- Puppeteer 棄用、Playwright 替代;
- WSL / Docker 通信問題。
到此這篇關(guān)于在Claude Code設(shè)置MCP服務(wù)器的文章就介紹到這了,更多相關(guān)Claude設(shè)置MCP服務(wù)器內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

一文詳解Claude Code中的五層架構(gòu):MCP、Skills、Agent、Subagents、Agent Teams怎么協(xié)
5 月初 Anthropic 官方公布了 Claude Code 的五層架構(gòu)——MCP / Skills / Agent / Subagents / Agent Teams,這個分層不是營銷話術(shù),每層都有明確的職責(zé)邊界和協(xié)作方向,下面2026-05-18
Claude Code完整指南:MCP、Skills、第三方模型配置一次搞定
Claude Code 是 Anthropic 官方出的命令行工具,直接在終端里跟 Claude 交互,干的事情就是幫你寫代碼、改代碼、跑命令,本文給大家介紹了Claude Code 完整上手指南,MCP、S2026-05-08
Claude Code Skills 從零開始創(chuàng)建自定義 MySQL MCP 完整指南
本文檔詳細(xì)介紹了使用ClaudeCodeSkills創(chuàng)建MySQL MCP的全流程,包括前期準(zhǔn)備、下載skills、使用mcp-builderskill設(shè)計MCP、修正需求、生成代碼、配置MCP等,感興趣的朋友跟隨2026-04-21




