作者 ref-tools · ref-tools/ref-tools-mcp
幫助編碼代理快速找到正確的文件 — 公開函式庫、私有倉庫、內部 PDF — 不浪費 context 在錯誤的頁面上。
ref-tools/ref-tools-mcp (由 Ref 提供) 提供兩個工具：專注於公開網路、GitHub 倉庫和你的私有資源的文件搜尋，加上一個回傳 markdown 的 URL 閱讀器。需要 REF_API_KEY。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"ref-tools": {
"command": "npx",
"args": [
"-y",
"ref-tools-mcp"
],
"_inferred": true
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"ref-tools": {
"command": "npx",
"args": [
"-y",
"ref-tools-mcp"
],
"_inferred": true
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"ref-tools": {
"command": "npx",
"args": [
"-y",
"ref-tools-mcp"
],
"_inferred": true
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"ref-tools": {
"command": "npx",
"args": [
"-y",
"ref-tools-mcp"
],
"_inferred": true
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "ref-tools",
"command": "npx",
"args": [
"-y",
"ref-tools-mcp"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"ref-tools": {
"command": {
"path": "npx",
"args": [
"-y",
"ref-tools-mcp"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add ref-tools -- npx -y ref-tools-mcp一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 代理自信地寫出與目前函式庫版本不符的程式碼時。
結果： 針對實際函式庫版本編譯的程式碼。
何時使用： 代理需要遵循公司特定的模式，而不是 StackOverflow 說的任何東西。
結果： 符合內部標準的輸出。
何時使用： 你想要文章文字，不需要導覽/廣告/JS 垃圾。
結果： 乾淨的內容，快速。
用官方文件引用來為 PR 審查奠定基礎
結合 Ref 的文件搜尋和 markdownify 處理不在 Ref 中的本地 PDF
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| ref_search_documentation | query: str, sources?: str[] | 為函式庫或內部文件問題奠定基礎 | 1 Ref API 呼叫 |
| ref_read_url | url: str | 拉取頁面作為乾淨的 markdown | 1 Ref API 呼叫 |
REF_API_KEY 儲存在環境變數中不要廣泛分享你的工作區金鑰；如果 Ref 支援，使用按使用者的金鑰401 未授權缺少或無效的 REF_API_KEY。
echo $REF_API_KEY搜尋回傳過期的結果私有資源重新索引可能延遲；從 Ref 儀表板強制重新索引。
ref_read_url 回傳空值某些網站阻止爬取。使用透過 markdownify 的 webpage-to-markdown 作為備用方案。
超過配額升級 Ref 方案或分散搜尋使用。
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| Context7 MCP | 你想要免費的公開函式庫文件擷取 | 沒有私有資源索引 |
| Apple Docs MCP / pg-aiguide | 你只關心特定平台的文件 | 有範圍限制；不是通用的 |