Tripo

You can run the Tripo3D MCP toolset as a local MCP server to access text/image/multi-view-to-3D conversion, texturing, animation, style transfer, format conversion, and balance checks from a client. It’s designed for local development and Cursor workflows, letting you invoke Tripo3D capabilities from a single MCP endpoint.

How to use

Start the MCP server and connect your MCP client to the provided endpoint. You can create 3D models from text prompts, convert images to 3D models, apply textures and animations, perform style transfers, convert between formats, and check your Tripo3D API balance. Use plain language prompts in your client to trigger the corresponding Tripo3D capabilities, and the server will route them to the right API calls.

How to install

Prerequisites you need before installation: a supported operating system (Windows, Linux, or macOS) and Python 3.8 or newer.

Then follow these concrete steps to set up and run the MCP server locally.

# Clone the project
git clone https://github.com/lxy2109/tripo-mcp.git

# Move into the project directory
cd tripo-mcp

# Install dependencies
pip install -r requirements.txt

# Start the local MCP server
python src/main.py

Additional configuration and usage notes

Configure your API key so the server can access Tripo3D services. You have two options:

Option A: Create a local environment file at the project root named .env with the following content.

TRIPO_API_KEY=你的Tripo3D_API_Key

Option B: Provide the API key in the MCP configuration file under the env section for the server.

If you want Cursor or a local runner to automatically start the service, create a configuration file named mcp.json at the project root using the example below.

{
  "mcpServers": {
    "tripo_mcp": {
      "command": "python",
      "args": [
        "你的绝对路径/src/main.py"
      ],
      "env": {
        "TRIPO_API_KEY": "你的Tripo3D_API_Key"
      },
      "url": "http://localhost:5001/mcp"
    }
  }
}

Troubleshooting and tips

If you encounter a non-responsive API key error, verify that the key is loaded from your .env file or from the mcp.json environment configuration. Ensure the local network can reach the Tripo3D API endpoints and that your Python environment is 3.8 or newer.

If dependency installation fails, confirm you have a reliable Python package index access and that you’re using a compatible Python version. Re-run the installation steps if needed.