Zoo MCP

🚀 Zoo模型上下文協議 (MCP) 服務器

Zoo模型上下文協議 (MCP) 服務器是一個託管各種Zoo內置實用工具的平臺。它提供了便捷的方式來運行和集成這些工具，無論是在本地環境還是在其他應用程序中。通過該服務器，用戶可以輕鬆地使用Zoo的功能，實現文本到CAD轉換等任務。

🚀 快速開始

Zoo MCP服務器為用戶提供了一個便捷的方式來使用各種Zoo內置實用工具。以下將詳細介紹使用該服務器的相關步驟。

✨ 主要特性

• 多方式啟動：支持通過多種命令啟動服務器，滿足不同場景需求。
• 豐富的集成能力：可以與Claude桌面、Claude Code、MCP Inspector、codex-cli等工具集成。
• 靈活的使用方式：既可以直接運行服務器，也可以將其集成到Python代碼中使用。

📦 安裝指南

前提條件

1. 獲取Zoo的API密鑰，可從這裡獲取。
2. 設置環境變量 ZOO_API_TOKEN 為你的API密鑰：

export ZOO_API_TOKEN="your_api_key_here"

安裝步驟

1. 確保已安裝uv。
2. 創建一個uv環境：

uv venv

3. 激活你的uv環境（可選）。
4. 從GitHub安裝該軟件包：

uv pip install git+ssh://git@github.com/KittyCAD/zoo-mcp.git

💻 使用示例

啟動服務器

使用uvx啟動

uvx zoo-mcp

本地啟動

uv run -m zoo_mcp

使用mcp包啟動

uv run mcp run src/zoo_mcp/server.py

集成到Python代碼中

直接運行服務器

from zoo_mcp.server import mcp

mcp.run()

使用單個工具

from mcp.server.fastmcp import FastMCP
from zoo_mcp.ai_tools import text_to_cad

mcp = FastMCP(name="My Example Server")


@mcp.tool()
async def my_text_text_to_cad(prompt: str) -> str:
    """
    示例工具，使用zoo_mcp.tools中的text_to_cad函數
    """
    return await text_to_cad(prompt=prompt)

與其他工具集成

與Claude桌面集成

uv run mcp install src/zoo_mcp/server.py

與Claude Code集成

claude mcp add --scope project "Zoo-MCP" uv -- --directory "$PWD"/src/zoo_mcp run server.py

使用MCP Inspector測試

uv run mcp dev src/zoo_mcp/server.py

與codex-cli一起運行

codex \
  -c 'mcp_servers.zoo.command="uvx"' \
  -c 'mcp_servers.zoo.args=["zoo-mcp"]' \
  -c mcp_servers.zoo.env.ZOO_API_TOKEN="$ZOO_API_TOKEN"

使用輔助腳本

./codex-zoo.sh

該腳本會提示輸入請求，使用Zoo MCP服務器運行Codex，並將JSONL轉錄文件（包括令牌使用情況）保存到 codex-run-<timestamp>.jsonl。

📚 詳細文檔

貢獻代碼

歡迎貢獻代碼！請在GitHub倉庫上創建一個issue或提交一個pull request。在合併之前，PR需要通過測試和代碼檢查。

代碼檢查和格式化

使用ruff進行代碼檢查和格式化：

uvx ruff check
uvx ruff format

類型檢查

使用ty進行類型檢查：

uvx ty check

測試

服務器的測試代碼位於 tests 目錄下。使用以下命令運行測試：

uv run pytest -n auto