Onetool MCP

🚀 One MCP開發工具集

🧿 專為開發者打造的一體化MCP工具，無需工具使用成本，避免上下文陳舊問題。它集成了100多種工具，涵蓋Brave、Google、Context7、Excalidraw、AWS、版本檢查器、Excel、文件操作、數據庫、圖像視覺、Playwright以及Chrome DevTools實用工具等等。

🚀 快速開始

問題所在

每個MCP服務器每次請求會消耗3K - 30K個令牌。連接5個服務器，在對話開始前就會消耗55K個令牌；連接10個以上服務器，消耗的令牌將達到100K。 按照這個計算方式，Claude Opus 4.5的輸入令牌成本為每百萬個5美元，20天 × 10次對話 × 10條消息 × 3K個令牌，意味著每個MCP服務器每月需花費30美元，即便你從未使用這些工具。 此外，還存在上下文陳舊問題 — 隨著添加的工具增多，你的AI實際上會變得更“笨”（Chroma Research, 2025）。

解決方案

OneTool是一個MCP服務器，它以Python API的形式提供工具。你的代理無需讀取工具定義，而是編寫代碼來調用工具：

>>> brave.search(query="react docs 2026")

只需配置一個MCP服務器，即可使用無限數量的工具。

“通過編寫代碼調用工具，代理可以更好地擴展。這將令牌使用量從150,000個減少到2,000個……節省了98.7%的成本。”

— Anthropic Engineering 使用OneTool，令牌使用量減少96%，成本降低30倍，且無上下文陳舊問題。 📖 閱讀完整故事

✨ 主要特性

📦 安裝指南

安裝需要 uv：

uv tool install 'onetool-mcp[all]'   # 安裝所有工具
onetool init -c ~/.onetool

添加到Claude Code：

claude mcp add onetool -- onetool --config ~/.onetool/onetool.yaml

或者手動添加到 ~/.claude/mcp.json：

{
  "mcpServers": {
    "onetool": {
      "command": "onetool",
      "args": ["--config", "/Users/yourname/.onetool/onetool.yaml"]
    }
  }
}

完成以上步驟後，所有100多種工具即可開箱即用。 驗證安裝：onetool init validate -c ~/.onetool/onetool.yaml 📖 完整安裝指南

💻 使用示例

基礎用法

>>> brave.search(query="react docs 2026")

高級用法

# 調用MCP服務器代理的GitHub工具獲取README.md內容
>>> mcp.call(server="github", tool="get_file_contents", arguments={"path": "README.md"})

# 調用自定義工具獲取維基百科文章摘要
>>> wiki.summary(title="Python_(programming_language)")

📚 詳細文檔

• 快速入門 - 30秒內完成首次工具調用
• 安裝指南 - 支持所有平臺
• 配置說明 - YAML配置文件架構
• 工具參考 - 所有100多種工具的詳細信息
• 安全指南 - 安全防護機制
• 擴展開發 - 自定義工具開發
• 開發文檔 - 內部開發者文檔
• 規範說明 - OpenSpec規範索引

🔧 技術細節

工具列表

27個以上工具包，230多種工具隨時可用：

MCP服務器代理

可以包裝任何現有的MCP服務器並顯式調用，通過簡單的yaml配置，無需工具使用成本：

# .onetool/onetool.yaml
servers:
  chrome_devtools:
    type: stdio
    command: npx
    args: ["-y", "@anthropic-ai/chrome-devtools-mcp@latest"]
  github:
    type: stdio
    command: npx
    args: ["-y", "@anthropic-ai/github-mcp-server@latest"]

>>> mcp.call(server="github", tool="get_file_contents", arguments={"path": "README.md"})

📖 配置指南

擴展工具

只需放置一個Python文件，即可創建一個工具包，無需註冊和配置：

# .onetool/tools/wiki.py
pack = "wiki"

def summary(*, title: str) -> str:
    """Get Wikipedia article summary."""
    import httpx
    url = f"https://en.wikipedia.org/api/rest_v1/page/summary/{title}"
    return httpx.get(url).json().get("extract", "Not found")

>>> wiki.summary(title="Python_(programming_language)")

📖 創建工具指南

📄 許可證

本項目採用GPLv3許可證。

其他信息

參考資料

• Code Execution with MCP - Anthropic Engineering
• Context Rot - Chroma Research

數據統計

OneTool會發送匿名啟動信息（事件類型、版本、操作系統），不包含個人數據。你可以通過以下方式選擇不參與統計：export DO_NOT_TRACK=1 或在 onetool.yaml 中設置 telemetry.enabled: false。詳細信息

問題反饋

請先檢查是否已有相關問題：

• 瀏覽問題跟蹤器：github.com/beycom/onetool-mcp/issues
• 使用GitHub語法搜索：is:issue repo:beycom/onetool-mcp <關鍵字> 提出新問題： github.com/beycom/onetool-mcp/issues/new

支持項目

如果你覺得OneTool很有用，請考慮支持我們：