zoo-mcp
An MCP server that provides access to the Zoo API for various CAD operations and tools.
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"zoo_mcp": {
"args": [
"zoo_mcp@0.10.1"
],
"command": "uvx"
}
}
}可用工具 （5 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
tavily_search 14 个参数 需填 1 项
Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.
必填参数：query
tavily_extract 6 个参数 需填 1 项
Extract content from URLs. Returns raw page content in markdown or text format.
必填参数：urls
tavily_crawl 11 个参数 需填 1 项
Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.
必填参数：url
tavily_map 8 个参数 需填 1 项
Map a website's structure. Returns a list of URLs found starting from the base URL.
必填参数：url
tavily_research 2 个参数 需填 1 项
Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.
必填参数：input
服务介绍
Zoo Model Context Protocol (MCP) Server
An MCP server housing various Zoo built utilities
Prerequisites
- An API key for Zoo, get one here
- An environment variable
ZOO_API_TOKENset to your API keyexport ZOO_API_TOKEN="your_api_key_here"
Installation
-
uv venv -
Install the package from GitHub
uv pip install git+ssh://git@github.com/KittyCAD/zoo-mcp.git
Running the Server
The server can be started by using uvx
uvx zoo-mcp
The server can be started locally by using uv and the zoo_mcp module
uv run -m zoo_mcp
The server can also be run with the mcp package
uv run mcp run src/zoo_mcp/server.py
Integrations
The server can be used as is by running the server or importing directly into your python code.
from zoo_mcp.server import mcp
mcp.run()
Individual tools can be used in your own python code as well
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)
The server can be integrated with Claude desktop using the following command
uv run mcp install src/zoo_mcp/server.py
The server can also be integrated with Claude Code using the following command
claude mcp add --scope project "Zoo-MCP" uv -- --directory "$PWD"/src/zoo_mcp run server.py
The server can also be tested using the MCP Inspector
uv run mcp dev src/zoo_mcp/server.py
For running with 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"
You can also use the helper script included in this repo:
./codex-zoo.sh
The script prompts for a request, runs Codex with the Zoo MCP server, and saves a JSONL transcript (including token usage) to codex-run-<timestamp>.jsonl.
Contributing
Contributions are welcome! Please open an issue or submit a pull request on the GitHub repository
PRs will need to pass tests and linting before being merged.
ruff is used for linting and formatting.
uvx ruff check
uvx ruff format
ty is used for type checking.
uvx ty check
Testing
The server includes tests located in tests. To run the tests, use the following command:
uv run pytest -n auto
