zoo_mcp 0.9.2__py3-none-any.whl

zoo_mcp-0.9.2.dist-info/METADATA

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: zoo_mcp
+Version: 0.9.2
+Summary: An MCP server utilizing Zoo's various tools
+Keywords: zoo,mcp,kittycad,3d,modeling,server
+Author: Ryan Barton
+Author-email: Ryan Barton <ryan@zoo.dev>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: aiofiles~=25.1
+Requires-Dist: kittycad<=2.0
+Requires-Dist: mcp[cli]>1.23.0,<2.0
+Requires-Dist: pillow>=11.3,<13.0
+Requires-Dist: truststore~=0.10
+Requires-Dist: zoo-kcl>=0.3.117
+Maintainer: Ryan Barton
+Maintainer-email: Ryan Barton <ryan@zoo.dev>
+Requires-Python: >=3.11, <3.14
+Project-URL: Repository, https://github.com/KittyCAD/zoo-mcp
+Description-Content-Type: text/markdown
+
+# Zoo Model Context Protocol (MCP) Server
+
+An [MCP server](https://modelcontextprotocol.io/docs/getting-started/intro) housing various Zoo built utilities
+
+<!-- mcp-name: io.github.KittyCAD/zoo-mcp -->
+
+## Prerequisites
+
+1. An API key for Zoo, get one [here](https://zoo.dev/account)
+2. An environment variable `ZOO_API_TOKEN` set to your API key
+    ```bash
+    export ZOO_API_TOKEN="your_api_key_here"
+    ```
+
+## Installation
+
+1. [Ensure uv has been installed](https://docs.astral.sh/uv/getting-started/installation/)
+
+2. [Create a uv environment](https://docs.astral.sh/uv/pip/environments/)
+    ```bash
+    uv venv
+    ```
+
+3. [Activate your uv environment (Optional)](https://docs.astral.sh/uv/pip/environments/#using-a-virtual-environment)
+
+4. Install the package from GitHub
+    ```bash
+    uv pip install git+ssh://git@github.com/KittyCAD/zoo-mcp.git
+    ```
+
+## Running the Server
+
+The server can be started by using [uvx](https://docs.astral.sh/uv/guides/tools/#running-tools)
+```bash
+uvx zoo-mcp
+```
+
+The server can be started locally by using uv and the zoo_mcp module
+```bash
+uv run -m zoo_mcp
+```
+
+The server can also be run with the [mcp package](https://github.com/modelcontextprotocol/python-sdk)
+```bash
+uv run mcp run src/zoo_mcp/server.py
+```
+
+## Integrations
+
+The server can be used as is by [running the server](#running-the-server) or importing directly into your python code.
+```python
+from zoo_mcp.server import mcp
+
+mcp.run()
+```
+
+Individual tools can be used in your own python code as well
+
+```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)
+```
+
+The server can be integrated with [Claude desktop](https://claude.ai/download) using the following command
+```bash 
+uv run mcp install src/zoo_mcp/server.py
+```
+
+The server can also be integrated with [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) using the following command
+```bash
+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](https://modelcontextprotocol.io/legacy/tools/inspector#python)
+```bash
+uv run mcp dev src/zoo_mcp/server.py
+```
+
+For running with [codex-cli](https://github.com/openai/codex)
+```bash
+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:
+```bash
+./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](https://github.com/KittyCAD/zoo-mcp)
+
+PRs will need to pass tests and linting before being merged.
+
+### [ruff](https://docs.astral.sh/ruff/) is used for linting and formatting.
+```bash
+uvx ruff check
+uvx ruff format
+```
+
+### [ty](https://docs.astral.sh/ty/) is used for type checking.
+```bash
+uvx ty check
+```
+
+## Testing
+
+The server includes tests located in [`tests`](`tests`). To run the tests, use the following command:
+```bash
+uv run pytest -n auto
+```

zoo_mcp-0.9.2.dist-info/RECORD

@@ -0,0 +1,14 @@
+zoo_mcp/__init__.py,sha256=ioSZucv__T4P7DJHUqRXbpGu_FyKJ340txRhK-NS8PE,2316
+zoo_mcp/__main__.py,sha256=xpPLf-1b_vqPxu1MpDD1F100VQ6tlVy8V-knr3zbmOY,380
+zoo_mcp/ai_tools.py,sha256=E9AmrZGdIcY5tZccjAIs_ptpWte3c6UjIBqzlpU-XZ4,10603
+zoo_mcp/kcl_docs.py,sha256=PEuzn2JzBVdyt3Kd1yzR0e5w-2ZKRT3M3YINt_XU70I,8633
+zoo_mcp/kcl_samples.py,sha256=3YL4Z168M3hF7EofMrs9trxFbBqMgMCHUpKNllWQxKw,10228
+zoo_mcp/server.py,sha256=GQ3b86_lf6IQ8eE-VRf1O1d2UdW7nMN5NY3-ufbsfcw,32113
+zoo_mcp/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+zoo_mcp/utils/image_utils.py,sha256=VZEvZgHRdgO__xIG-YfsA_guLaOI91HzICRKj8XPUww,2816
+zoo_mcp/zoo_tools.py,sha256=m4Fn7joqtYT4KP3r-QLm1c-9ilIvISpMh63sy_2fgq0,43373
+zoo_mcp-0.9.2.dist-info/licenses/LICENSE,sha256=-49Z0mKREsT7vQloQJOFT9VUdxvTIhvXhT0S3E90gks,1060
+zoo_mcp-0.9.2.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+zoo_mcp-0.9.2.dist-info/entry_points.txt,sha256=JhmRyIycFN2Akep_1yGhQq6bzIydJclJHunz6jateW4,49
+zoo_mcp-0.9.2.dist-info/METADATA,sha256=vsssKRYe0Bns5jO03EnuNXnmfJ0Vnd1uR-U3xFSIFB8,4518
+zoo_mcp-0.9.2.dist-info/RECORD,,

zoo_mcp-0.9.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.26
+Root-Is-Purelib: true
+Tag: py3-none-any

zoo_mcp-0.9.2.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+zoo-mcp = zoo_mcp.server:main
+

zoo_mcp-0.9.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zoo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.