Zoo MCP

🚀 Zoo Model Context Protocol (MCP) Server

MCPサーバーは、Zooで構築された様々なユーティリティを提供します。

🚀 クイックスタート

🔍 前提条件

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と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()

個々のツールも独自のPythonコードで使用できます。

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:
    """
    Example tool that uses the text_to_cad function from zoo_mcp.tools
    """
    return await text_to_cad(prompt=prompt)

高度な使用法

サーバーは以下のコマンドを使用してClaude desktopと統合できます。

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リポジトリでイシューを開くか、プルリクエストを送信してください。

PRはマージされる前にテストとリントを通過する必要があります。

ruff を使用したリントとフォーマット

uvx ruff check
uvx ruff format

ty を使用した型チェック

uvx ty check

🧪 テスト

サーバーには tests ディレクトリにテストが含まれています。テストを実行するには、以下のコマンドを使用してください。

uv run pytest -n auto