# Directory Structure
```
├── .github
│ └── workflows
│ ├── publish.yml
│ └── release.yaml
├── .gitignore
├── LICENSE
├── main.py
├── pyproject.toml
├── README.md
├── src
│ └── server.py
└── succeed.jpg
```
# Files
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
```
# Python
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
*.egg-info/
.installed.cfg
*.egg
# Virtual Environment
venv/
ENV/
env/
.env
.venv
env.bak/
venv.bak/
# IDE specific files
.idea/
.vscode/
*.swp
*.swo
.DS_Store
*.sublime-workspace
*.sublime-project
# Testing
.tox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
.hypothesis/
.pytest_cache/
htmlcov/
# Distribution / packaging
.Python
*.manifest
*.spec
pip-log.txt
pip-delete-this-directory.txt
# Jupyter Notebook
.ipynb_checkpoints
# pyenv
.python-version
# mypy
.mypy_cache/
.dmypy.json
dmypy.json
# Logs and databases
*.log
*.sqlite
*.db
uv.lock
```
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
```markdown
# Tripo MCP Server
Tripo MCP provides an interface between AI assistants and [Tripo AI](https://www.tripo3d.ai) via [Model Context Protocol (MCP)](https://github.com/anthropics/anthropic-cookbook/tree/main/mcp).
> **Note:** This project is in alpha. Currently, it supports Tripo Blender Addon integration.
## Current Features
- Generate 3D asset from natural language using Tripo's API and import to Blender
- Compatible with Claude and other MCP-enabled AI assistants
## Quick Start
### Prerequisites
- Python 3.10+
- [Blender](https://www.blender.org/download/)
- [Tripo AI Blender Addon](https://www.tripo3d.ai/app/home)
- Claude for Desktop or Cursor IDE
### Installation
1. Install Tripo AI Blender Addon from [Tripo AI's website](https://www.tripo3d.ai/app/home)
2. Configure the MCP server in Claude Desktop or Cursor.
* `pip install uv`
* set mcp in cursor
```json
{
"mcpServers": {
"tripo-mcp": {
"command": "uvx",
"args": [
"tripo-mcp"
]
}
}
}
```
* Then you will get a green dot like this:
### Usage
1. Enable Tripo AI Blender Addon and start blender mcp server.
2. Chat using cursor or claude. E.g., "Generate a 3D model of a futuristic chair".
## Acknowledgements
- **[Tripo AI](https://www.tripo3d.ai)**
- **[blender-mcp](https://github.com/ahujasid/blender-mcp)** by [Siddharth Ahuja](https://github.com/ahujasid)
**Special Thanks**
Special thanks to Siddharth Ahuja for the blender-mcp project, which provided inspiring ideas for MCP + 3D.
```
--------------------------------------------------------------------------------
/main.py:
--------------------------------------------------------------------------------
```python
from src.server import main as server_main
if __name__ == "__main__":
"""Entry point for the Tripo MCP package"""
server_main()
```
--------------------------------------------------------------------------------
/.github/workflows/publish.yml:
--------------------------------------------------------------------------------
```yaml
name: Publish to PyPI
on:
release:
types: [published]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Set up Python
uses: actions/setup-python@v4
with:
python-version: '3.10'
- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install build
- name: Build package
run: python -m build
- name: Publish package
uses: pypa/[email protected]
with:
password: ${{ secrets.PYPI_API_TOKEN }}
```
--------------------------------------------------------------------------------
/.github/workflows/release.yaml:
--------------------------------------------------------------------------------
```yaml
name: Publish to PyPI
on:
release:
types: [created]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Set up Python
uses: actions/setup-python@v4
with:
python-version: '3.x'
- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install build twine
- name: Build package
run: python -m build
- name: Publish to PyPI
env:
TWINE_USERNAME: __token__
TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
run: |
python -m twine upload dist/*
```
--------------------------------------------------------------------------------
/pyproject.toml:
--------------------------------------------------------------------------------
```toml
[project]
name = "tripo-mcp"
version = "0.1.2"
description = "MCP (Model Control Protocol) integration for Tripo"
authors = [
{name = "Allen Dang", email = "[email protected]"},
{name = "pookiefoof", email = "[email protected]"},
{name = "Ding Liang", email = "[email protected]"},
]
license = {text = "MIT"}
readme = "README.md"
requires-python = ">=3.10"
keywords = ["mcp", "blender", "3d", "automation"]
classifiers = [
"Development Status :: 3 - Alpha",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.10",
]
dependencies = [
"tripo3d>=0.2.0",
"mcp[cli]>=1.4.1",
]
[project.optional-dependencies]
dev = [
]
[project.scripts]
tripo-mcp = "server:main"
[build-system]
requires = ["setuptools>=61.0", "wheel"]
build-backend = "setuptools.build_meta"
[tool.setuptools]
package-dir = {"" = "src"}
```
--------------------------------------------------------------------------------
/src/server.py:
--------------------------------------------------------------------------------
```python
"""
MIT License
Copyright (c) 2025 Siddharth Ahuja
Copyright (c) 2025 for additions
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.
This file is based on work by Siddharth Ahuja, with additional contributions
for Tripo MCP functionality.
"""
from mcp.server.fastmcp import FastMCP, Context
import sys
from pathlib import Path
from typing import Dict, Any
import socket
import json
import logging
from dataclasses import dataclass
from contextlib import asynccontextmanager
from typing import AsyncIterator, Dict, Any, List
# Configure logging
logging.basicConfig(
level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
)
logger = logging.getLogger("BlenderMCPServer")
sys.path.insert(0, str(Path(__file__).parent.parent))
from tripo3d import TripoClient, TaskStatus
@dataclass
class BlenderConnection:
host: str
port: int
sock: socket.socket = (
None # Changed from 'socket' to 'sock' to avoid naming conflict
)
def connect(self) -> bool:
"""Connect to the Blender addon socket server"""
if self.sock:
return True
try:
self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
self.sock.connect((self.host, self.port))
logger.info(f"Connected to Blender at {self.host}:{self.port}")
return True
except Exception as e:
logger.error(f"Failed to connect to Blender: {str(e)}")
self.sock = None
return False
def disconnect(self):
"""Disconnect from the Blender addon"""
if self.sock:
try:
self.sock.close()
except Exception as e:
logger.error(f"Error disconnecting from Blender: {str(e)}")
finally:
self.sock = None
def receive_full_response(self, sock, buffer_size=8192):
"""Receive the complete response, potentially in multiple chunks"""
chunks = []
# Use a consistent timeout value that matches the addon's timeout
sock.settimeout(15.0) # Match the addon's timeout
try:
while True:
try:
chunk = sock.recv(buffer_size)
if not chunk:
# If we get an empty chunk, the connection might be closed
if (
not chunks
): # If we haven't received anything yet, this is an error
raise Exception(
"Connection closed before receiving any data"
)
break
chunks.append(chunk)
# Check if we've received a complete JSON object
try:
data = b"".join(chunks)
json.loads(data.decode("utf-8"))
# If we get here, it parsed successfully
logger.info(f"Received complete response ({len(data)} bytes)")
return data
except json.JSONDecodeError:
# Incomplete JSON, continue receiving
continue
except socket.timeout:
# If we hit a timeout during receiving, break the loop and try to use what we have
logger.warning("Socket timeout during chunked receive")
break
except (ConnectionError, BrokenPipeError, ConnectionResetError) as e:
logger.error(f"Socket connection error during receive: {str(e)}")
raise # Re-raise to be handled by the caller
except socket.timeout:
logger.warning("Socket timeout during chunked receive")
except Exception as e:
logger.error(f"Error during receive: {str(e)}")
raise
# If we get here, we either timed out or broke out of the loop
# Try to use what we have
if chunks:
data = b"".join(chunks)
logger.info(f"Returning data after receive completion ({len(data)} bytes)")
try:
# Try to parse what we have
json.loads(data.decode("utf-8"))
return data
except json.JSONDecodeError:
# If we can't parse it, it's incomplete
raise Exception("Incomplete JSON response received")
else:
raise Exception("No data received")
def send_command(
self, command_type: str, params: Dict[str, Any] = None
) -> Dict[str, Any]:
"""Send a command to Blender and return the response"""
if not self.sock and not self.connect():
raise ConnectionError("Not connected to Blender")
command = {"type": command_type, "params": params or {}}
try:
# Log the command being sent
logger.info(f"Sending command: {command_type} with params: {params}")
# Send the command
self.sock.sendall(json.dumps(command).encode("utf-8"))
logger.info(f"Command sent, waiting for response...")
# Set a timeout for receiving - use the same timeout as in receive_full_response
self.sock.settimeout(15.0) # Match the addon's timeout
# Receive the response using the improved receive_full_response method
response_data = self.receive_full_response(self.sock)
logger.info(f"Received {len(response_data)} bytes of data")
response = json.loads(response_data.decode("utf-8"))
logger.info(f"Response parsed, status: {response.get('status', 'unknown')}")
if response.get("status") == "error":
logger.error(f"Blender error: {response.get('message')}")
raise Exception(response.get("message", "Unknown error from Blender"))
return response.get("result", {})
except socket.timeout:
logger.error("Socket timeout while waiting for response from Blender")
# Don't try to reconnect here - let the get_blender_connection handle reconnection
# Just invalidate the current socket so it will be recreated next time
self.sock = None
raise Exception(
"Timeout waiting for Blender response - try simplifying your request"
)
except (ConnectionError, BrokenPipeError, ConnectionResetError) as e:
logger.error(f"Socket connection error: {str(e)}")
self.sock = None
raise Exception(f"Connection to Blender lost: {str(e)}")
except json.JSONDecodeError as e:
logger.error(f"Invalid JSON response from Blender: {str(e)}")
# Try to log what was received
if "response_data" in locals() and response_data:
logger.error(f"Raw response (first 200 bytes): {response_data[:200]}")
raise Exception(f"Invalid response from Blender: {str(e)}")
except Exception as e:
logger.error(f"Error communicating with Blender: {str(e)}")
# Don't try to reconnect here - let the get_blender_connection handle reconnection
self.sock = None
raise Exception(f"Communication error with Blender: {str(e)}")
@asynccontextmanager
async def server_lifespan(server: FastMCP) -> AsyncIterator[Dict[str, Any]]:
"""Manage server startup and shutdown lifecycle"""
# We don't need to create a connection here since we're using the global connection
# for resources and tools
try:
# Just log that we're starting up
logger.info("Blender server starting up")
# Try to connect to Blender on startup to verify it's available
try:
# This will initialize the global connection if needed
blender = get_blender_connection()
logger.info("Successfully connected to Blender on startup")
except Exception as e:
logger.warning(f"Could not connect to Blender on startup: {str(e)}")
logger.warning(
"Make sure the Blender addon is running before using Blender resources or tools"
)
# Return an empty context - we're using the global connection
yield {}
finally:
# Clean up the global connection on shutdown
global _blender_connection
if _blender_connection:
logger.info("Disconnecting from Blender on shutdown")
_blender_connection.disconnect()
_blender_connection = None
logger.info("BlenderMCP server shut down")
mcp = FastMCP(
name="Tripo MCP",
instructions="MCP for Tripo Blender addon",
lifespan=server_lifespan,
# host="127.0.0.1",
# port=8392,
)
_blender_connection = None
_polyhaven_enabled = False # Add this global variable
_tripo_apikey = ""
def get_blender_connection():
"""Get or create a persistent Blender connection"""
global _blender_connection, _polyhaven_enabled, _tripo_apikey # Add _polyhaven_enabled to globals
# If we have an existing connection, check if it's still valid
if _blender_connection is not None:
try:
# First check if PolyHaven is enabled by sending a ping command
result = _blender_connection.send_command("get_tripo_apikey")
_tripo_apikey = result.get("api_key", "")
result = _blender_connection.send_command("get_polyhaven_status")
# Store the PolyHaven status globally
_polyhaven_enabled = result.get("enabled", False)
return _blender_connection
except Exception as e:
# Connection is dead, close it and create a new one
logger.warning(f"Existing connection is no longer valid: {str(e)}")
try:
_blender_connection.disconnect()
except:
pass
_blender_connection = None
# Create a new connection if needed
if _blender_connection is None:
_blender_connection = BlenderConnection(host="localhost", port=9876)
if not _blender_connection.connect():
logger.error("Failed to connect to Blender")
_blender_connection = None
raise Exception(
"Could not connect to Blender. Make sure the Blender addon is running."
)
logger.info("Created new persistent connection to Blender")
return _blender_connection
@mcp.tool()
def get_scene_info(ctx: Context) -> str:
"""Get detailed information about the current Blender scene"""
try:
blender = get_blender_connection()
result = blender.send_command("get_scene_info")
# Just return the JSON representation of what Blender sent us
return json.dumps(result, indent=2)
except Exception as e:
logger.error(f"Error getting scene info from Blender: {str(e)}")
return f"Error getting scene info: {str(e)}"
@mcp.tool()
def get_object_info(ctx: Context, object_name: str) -> str:
"""
Get detailed information about a specific object in the Blender scene.
Parameters:
- object_name: The name of the object to get information about
"""
try:
blender = get_blender_connection()
result = blender.send_command("get_object_info", {"name": object_name})
# Just return the JSON representation of what Blender sent us
return json.dumps(result, indent=2)
except Exception as e:
logger.error(f"Error getting object info from Blender: {str(e)}")
return f"Error getting object info: {str(e)}"
@mcp.tool()
def create_object(
ctx: Context,
type: str = "CUBE",
name: str = None,
location: List[float] = None,
rotation: List[float] = None,
scale: List[float] = None,
) -> str:
"""
Create a new object in the Blender scene.
Parameters:
- type: Object type (CUBE, SPHERE, CYLINDER, PLANE, CONE, TORUS, EMPTY, CAMERA, LIGHT)
- name: Optional name for the object
- location: Optional [x, y, z] location coordinates
- rotation: Optional [x, y, z] rotation in radians
- scale: Optional [x, y, z] scale factors
"""
try:
# Get the global connection
blender = get_blender_connection()
# Set default values for missing parameters
loc = location or [0, 0, 0]
rot = rotation or [0, 0, 0]
sc = scale or [1, 1, 1]
params = {"type": type, "location": loc, "rotation": rot, "scale": sc}
if name:
params["name"] = name
result = blender.send_command("create_object", params)
return f"Created {type} object: {result['name']}"
except Exception as e:
logger.error(f"Error creating object: {str(e)}")
return f"Error creating object: {str(e)}"
@mcp.tool()
def modify_object(
ctx: Context,
name: str,
location: List[float] = None,
rotation: List[float] = None,
scale: List[float] = None,
visible: bool = None,
) -> str:
"""
Modify an existing object in the Blender scene.
Parameters:
- name: Name of the object to modify
- location: Optional [x, y, z] location coordinates
- rotation: Optional [x, y, z] rotation in radians
- scale: Optional [x, y, z] scale factors
- visible: Optional boolean to set visibility
"""
try:
# Get the global connection
blender = get_blender_connection()
params = {"name": name}
if location is not None:
params["location"] = location
if rotation is not None:
params["rotation"] = rotation
if scale is not None:
params["scale"] = scale
if visible is not None:
params["visible"] = visible
result = blender.send_command("modify_object", params)
return f"Modified object: {result['name']}"
except Exception as e:
logger.error(f"Error modifying object: {str(e)}")
return f"Error modifying object: {str(e)}"
@mcp.tool()
def delete_object(ctx: Context, name: str) -> str:
"""
Delete an object from the Blender scene.
Parameters:
- name: Name of the object to delete
"""
try:
# Get the global connection
blender = get_blender_connection()
result = blender.send_command("delete_object", {"name": name})
return f"Deleted object: {name}"
except Exception as e:
logger.error(f"Error deleting object: {str(e)}")
return f"Error deleting object: {str(e)}"
@mcp.tool()
def set_material(
ctx: Context, object_name: str, material_name: str = None, color: List[float] = None
) -> str:
"""
Set or create a material for an object.
Parameters:
- object_name: Name of the object to apply the material to
- material_name: Optional name of the material to use or create
- color: Optional [R, G, B] color values (0.0-1.0)
"""
try:
# Get the global connection
blender = get_blender_connection()
params = {"object_name": object_name}
if material_name:
params["material_name"] = material_name
if color:
params["color"] = color
result = blender.send_command("set_material", params)
return f"Applied material to {object_name}: {result.get('material_name', 'unknown')}"
except Exception as e:
logger.error(f"Error setting material: {str(e)}")
return f"Error setting material: {str(e)}"
@mcp.tool()
def execute_blender_code(ctx: Context, code: str) -> str:
"""
Execute arbitrary Python code in Blender.
Parameters:
- code: The Python code to execute
"""
try:
# Get the global connection
blender = get_blender_connection()
result = blender.send_command("execute_code", {"code": code})
return f"Code executed successfully: {result.get('result', '')}"
except Exception as e:
logger.error(f"Error executing code: {str(e)}")
return f"Error executing code: {str(e)}"
@mcp.tool()
def get_polyhaven_categories(ctx: Context, asset_type: str = "hdris") -> str:
"""
Get a list of categories for a specific asset type on Polyhaven.
Parameters:
- asset_type: The type of asset to get categories for (hdris, textures, models, all)
"""
try:
blender = get_blender_connection()
if not _polyhaven_enabled:
return "PolyHaven integration is disabled. Select it in the sidebar in BlenderMCP, then run it again."
result = blender.send_command(
"get_polyhaven_categories", {"asset_type": asset_type}
)
if "error" in result:
return f"Error: {result['error']}"
# Format the categories in a more readable way
categories = result["categories"]
formatted_output = f"Categories for {asset_type}:\n\n"
# Sort categories by count (descending)
sorted_categories = sorted(categories.items(), key=lambda x: x[1], reverse=True)
for category, count in sorted_categories:
formatted_output += f"- {category}: {count} assets\n"
return formatted_output
except Exception as e:
logger.error(f"Error getting Polyhaven categories: {str(e)}")
return f"Error getting Polyhaven categories: {str(e)}"
@mcp.tool()
def search_polyhaven_assets(
ctx: Context, asset_type: str = "all", categories: str = None
) -> str:
"""
Search for assets on Polyhaven with optional filtering.
Parameters:
- asset_type: Type of assets to search for (hdris, textures, models, all)
- categories: Optional comma-separated list of categories to filter by
Returns a list of matching assets with basic information.
"""
try:
blender = get_blender_connection()
result = blender.send_command(
"search_polyhaven_assets",
{"asset_type": asset_type, "categories": categories},
)
if "error" in result:
return f"Error: {result['error']}"
# Format the assets in a more readable way
assets = result["assets"]
total_count = result["total_count"]
returned_count = result["returned_count"]
formatted_output = f"Found {total_count} assets"
if categories:
formatted_output += f" in categories: {categories}"
formatted_output += f"\nShowing {returned_count} assets:\n\n"
# Sort assets by download count (popularity)
sorted_assets = sorted(
assets.items(), key=lambda x: x[1].get("download_count", 0), reverse=True
)
for asset_id, asset_data in sorted_assets:
formatted_output += (
f"- {asset_data.get('name', asset_id)} (ID: {asset_id})\n"
)
formatted_output += (
f" Type: {['HDRI', 'Texture', 'Model'][asset_data.get('type', 0)]}\n"
)
formatted_output += (
f" Categories: {', '.join(asset_data.get('categories', []))}\n"
)
formatted_output += (
f" Downloads: {asset_data.get('download_count', 'Unknown')}\n\n"
)
return formatted_output
except Exception as e:
logger.error(f"Error searching Polyhaven assets: {str(e)}")
return f"Error searching Polyhaven assets: {str(e)}"
@mcp.tool()
def download_polyhaven_asset(
ctx: Context,
asset_id: str,
asset_type: str,
resolution: str = "1k",
file_format: str = None,
) -> str:
"""
Download and import a Polyhaven asset into Blender.
Parameters:
- asset_id: The ID of the asset to download
- asset_type: The type of asset (hdris, textures, models)
- resolution: The resolution to download (e.g., 1k, 2k, 4k)
- file_format: Optional file format (e.g., hdr, exr for HDRIs; jpg, png for textures; gltf, fbx for models)
Returns a message indicating success or failure.
"""
try:
blender = get_blender_connection()
result = blender.send_command(
"download_polyhaven_asset",
{
"asset_id": asset_id,
"asset_type": asset_type,
"resolution": resolution,
"file_format": file_format,
},
)
if "error" in result:
return f"Error: {result['error']}"
if result.get("success"):
message = result.get(
"message", "Asset downloaded and imported successfully"
)
# Add additional information based on asset type
if asset_type == "hdris":
return f"{message}. The HDRI has been set as the world environment."
elif asset_type == "textures":
material_name = result.get("material", "")
maps = ", ".join(result.get("maps", []))
return (
f"{message}. Created material '{material_name}' with maps: {maps}."
)
elif asset_type == "models":
return f"{message}. The model has been imported into the current scene."
else:
return message
else:
return f"Failed to download asset: {result.get('message', 'Unknown error')}"
except Exception as e:
logger.error(f"Error downloading Polyhaven asset: {str(e)}")
return f"Error downloading Polyhaven asset: {str(e)}"
@mcp.tool()
def set_texture(ctx: Context, object_name: str, texture_id: str) -> str:
"""
Apply a previously downloaded Polyhaven texture to an object.
Parameters:
- object_name: Name of the object to apply the texture to
- texture_id: ID of the Polyhaven texture to apply (must be downloaded first)
Returns a message indicating success or failure.
"""
try:
# Get the global connection
blender = get_blender_connection()
result = blender.send_command(
"set_texture", {"object_name": object_name, "texture_id": texture_id}
)
if "error" in result:
return f"Error: {result['error']}"
if result.get("success"):
material_name = result.get("material", "")
maps = ", ".join(result.get("maps", []))
# Add detailed material info
material_info = result.get("material_info", {})
node_count = material_info.get("node_count", 0)
has_nodes = material_info.get("has_nodes", False)
texture_nodes = material_info.get("texture_nodes", [])
output = f"Successfully applied texture '{texture_id}' to {object_name}.\n"
output += f"Using material '{material_name}' with maps: {maps}.\n\n"
output += f"Material has nodes: {has_nodes}\n"
output += f"Total node count: {node_count}\n\n"
if texture_nodes:
output += "Texture nodes:\n"
for node in texture_nodes:
output += f"- {node['name']} using image: {node['image']}\n"
if node["connections"]:
output += " Connections:\n"
for conn in node["connections"]:
output += f" {conn}\n"
else:
output += "No texture nodes found in the material.\n"
return output
else:
return f"Failed to apply texture: {result.get('message', 'Unknown error')}"
except Exception as e:
logger.error(f"Error applying texture: {str(e)}")
return f"Error applying texture: {str(e)}"
@mcp.tool()
def get_polyhaven_status(ctx: Context) -> str:
"""
Check if PolyHaven integration is enabled in Blender.
Returns a message indicating whether PolyHaven features are available.
"""
try:
blender = get_blender_connection()
result = blender.send_command("get_polyhaven_status")
enabled = result.get("enabled", False)
message = result.get("message", "")
return message
except Exception as e:
logger.error(f"Error checking PolyHaven status: {str(e)}")
return f"Error checking PolyHaven status: {str(e)}"
@mcp.prompt()
def asset_creation_strategy() -> str:
"""Defines the preferred strategy for creating assets in Blender"""
return """When creating 3D content in Blender, always start by checking if PolyHaven is available:
0. Before anything, always check the scene from get_scene_info()
1. First use get_polyhaven_status() to verify if PolyHaven integration is enabled.
2. If PolyHaven is enabled:
- For objects/models: Use download_polyhaven_asset() with asset_type="models"
- For materials/textures: Use download_polyhaven_asset() with asset_type="textures"
- For environment lighting: Use download_polyhaven_asset() with asset_type="hdris"
3. If PolyHaven is disabled or when falling back to basic tools:
- create_object() for basic primitives (CUBE, SPHERE, CYLINDER, etc.)
- set_material() for basic colors and materials
Only fall back to basic creation tools when:
- PolyHaven is disabled
- A simple primitive is explicitly requested
- No suitable PolyHaven asset exists
- The task specifically requires a basic material/color
"""
@mcp.tool()
async def create_3d_model_from_text(
describe_the_look_of_object: str, face_limit: int = -1
) -> Dict[str, Any]:
"""
Create a 3D model from a text description using the Tripo API.
IMPORTANT: This tool initiates a 3D model generation task but does NOT wait for completion.
After calling this tool, you MUST repeatedly call the get_task_status tool with the returned
task_id until the task status is SUCCESS or a terminal error state.
Typical workflow:
1. Call create_3d_model_from_text to start the task
2. Get the task_id from the response
3. Call get_task_status with the task_id
4. If status is not SUCCESS, wait a moment and call get_task_status again
5. Repeat until status is SUCCESS or a terminal error state
6. When status is SUCCESS, use the pbr_model_url from the response
Args:
describe_the_look_of_object: A detailed description of the object to generate.
face_limit: The maximum number of faces in the model.
auto_size: Whether to automatically size the model.
Returns:
A dictionary containing the task ID and instructions for checking the status.
"""
# Get the API key from environment variable
# api_key = os.environ.get("TRIPO_API_KEY")
get_blender_connection()
blender = get_blender_connection()
api_key = _tripo_apikey
if not api_key:
raise ValueError(
"It may take some more time to correctly re-enter the tripo function. You can first check the scene and then try the tripo function again later"
)
# Create the Tripo client
async with TripoClient(api_key=api_key) as client:
# Create a text-to-model task
task_id = await client.text_to_model(
prompt=describe_the_look_of_object,
face_limit=face_limit,
)
# Get initial task status
task = await client.get_task(task_id)
# Return immediately with task ID and status
return {
"task_id": task_id,
"status": str(task.status),
"progress": task.progress,
"message": "Task created successfully. The 3D model generation is in progress.",
"next_step": "You MUST now call get_task_status with this task_id to check progress.",
"important_note": "3D model generation takes 3-5 minutes. You need to repeatedly call get_task_status until completion.",
"workflow": [
"1. You've completed this step by calling create_3d_model_from_text",
"2. Now call get_task_status with task_id: " + task_id,
"3. If status is not SUCCESS, wait and call get_task_status again",
"4. When status is SUCCESS, use the pbr_model_url from the response",
],
}
@mcp.tool()
async def create_3d_model_from_image(
image: str, face_limit: int = -1
) -> Dict[str, Any]:
"""
Create a 3D model from an image using the Tripo API.
IMPORTANT: This tool initiates a 3D model generation task but does NOT wait for completion.
After calling this tool, you MUST repeatedly call the get_task_status tool with the returned
task_id until the task status is SUCCESS or a terminal error state.
Typical workflow:
1. Call create_3d_model_from_image to start the task
2. Get the task_id from the response
3. Call get_task_status with the task_id
4. If status is not SUCCESS, wait a moment and call get_task_status again
5. Repeat until status is SUCCESS or a terminal error state
6. When status is SUCCESS, use the pbr_model_url from the response
Args:
image: The local path or url to the image file.
face_limit: The maximum number of faces in the model.
auto_size: Whether to automatically size the model.
Returns:
A dictionary containing the task ID and instructions for checking the status.
"""
# Get the API key from environment variable
# api_key = os.environ.get("TRIPO_API_KEY")
get_blender_connection()
api_key = _tripo_apikey
if not api_key:
raise ValueError(
"It may take some more time to correctly re-enter the tripo function. You can first check the scene and then try the tripo function again later"
)
# Create the Tripo client
async with TripoClient(api_key=api_key) as client:
# Create a text-to-model task
task_id = await client.image_to_model(
image=image,
face_limit=face_limit,
)
# Get initial task status
task = await client.get_task(task_id)
# Return immediately with task ID and status
return {
"task_id": task_id,
"status": str(task.status),
"progress": task.progress,
"message": "Task created successfully. The 3D model generation is in progress.",
"next_step": "You MUST now call get_task_status with this task_id to check progress.",
"important_note": "3D model generation takes 3-5 minutes. You need to repeatedly call get_task_status until completion.",
"workflow": [
"1. You've completed this step by calling create_3d_model_from_image",
"2. Now call get_task_status with task_id: " + task_id,
"3. If status is not SUCCESS, wait and call get_task_status again",
"4. When status is SUCCESS, use the pbr_model_url from the response",
],
}
@mcp.tool()
def import_tripo_glb_model(ctx: Context, glb_url: str) -> str:
"""
Import a GLB model from URL into Blender scene
Parameters:
- glb_url: Download URL of the GLB model file
Returns:
Result message of the import operation
"""
try:
blender = get_blender_connection()
result = blender.send_command("import_tripo_glb_model", {"url": glb_url})
if "error" in result:
return f"Import failed: {result['error']}"
if result.get("status") == "success":
output = ["Successfully imported models:"]
for model in result.get("models", []):
dim = model["dimensions"]
output.append(
f"• {model['name']} | Dimensions: "
f"{dim['x']} x {dim['y']} x {dim['z']} meters"
)
if not output:
output.append("No models found in imported file")
return "\n".join(output)
else:
return f"Import failed: {result.get('message', 'Unknown error')}"
except Exception as e:
logger.error(f"Error importing GLB model: {str(e)}")
return f"GLB model import failed: {str(e)}"
@mcp.tool()
async def get_task_status(task_id: str) -> Dict[str, Any]:
"""
Get the status of a 3D model generation task.
IMPORTANT: This tool checks the status of a task started by create_3d_model_from_text.
You may need to call this tool MULTIPLE TIMES until the task completes.
Typical workflow:
1. Call this tool with the task_id from create_3d_model_from_text
2. Check the status in the response:
- If status is SUCCESS, the task is complete and you can use the pbr_model_url
- If status is FAILED, CANCELLED, BANNED, or EXPIRED, the task failed
- If status is anything else, the task is still in progress
3. If the task is still in progress, wait a moment and call this tool again
Args:
task_id: The ID of the task to check (obtained from create_3d_model_from_text).
Returns:
A dictionary containing the task status and other information.
"""
# Get the API key from environment variable
# api_key = os.environ.get("TRIPO_API_KEY")
get_blender_connection()
api_key = _tripo_apikey
if not api_key:
raise ValueError(
"It may take some more time to correctly re-enter the tripo function. You can first check the scene and then try the tripo function again later"
)
# Create the Tripo client
async with TripoClient(api_key=api_key) as client:
# Get task status
task = await client.get_task(task_id)
# Ensure task is not None
if task is None:
raise ValueError(
f"Failed to retrieve task information for task ID: {task_id}"
)
# Create result dictionary
result = {
"task_id": task_id,
"status": str(task.status),
"progress": task.progress,
}
# Add output fields if task is successful and output is available
if task.status == TaskStatus.SUCCESS and task.output:
result.update(
{
"base_model_url": task.output.base_model,
"model_url": task.output.model,
"pbr_model_url": task.output.pbr_model,
"rendered_image_url": task.output.rendered_image,
"message": "Task completed successfully! You can now use the pbr_model_url.",
"next_step": "Use the pbr_model_url to access the 3D model, download it through import_tripo_glb_model tool",
}
)
if not task.output.pbr_model:
result["warning"] = (
"Model generated but PBR model URL is not available."
)
elif task.status == TaskStatus.SUCCESS:
result["message"] = (
"Task completed successfully but no output data is available."
)
result["next_step"] = (
"Try creating a new model with a different description."
)
elif task.status in (
TaskStatus.FAILED,
TaskStatus.CANCELLED,
TaskStatus.BANNED,
TaskStatus.EXPIRED,
):
result["message"] = f"Task failed with status: {task.status}"
result["next_step"] = (
"Try creating a new model with a different description."
)
else:
result["message"] = (
f"Task is still in progress. Current status: {task.status}, Progress: {task.progress}%"
)
result["next_step"] = (
"IMPORTANT: You must call get_task_status again with this task_id to continue checking progress."
)
result["wait_message"] = (
"3D model generation typically takes 3-5 minutes. Please be patient and keep checking."
)
return result
def main():
# mcp.run("sse")
mcp.run(transport="stdio")
if __name__ == "__main__":
main()
```