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