Trellis MCP Ts

mcp-ts服务器

一种基于类型脚本的MCP（模型上下文协议）服务器，与Trellis API集成。

Docker设置

先决条件

• Docker和Docker Compose已安装在您的系统上
• 所需的环境变量（请参阅配置部分）

配置

创建一个 .env 项目根目录中的文件，包含以下变量：

# Required
TRELLIS_API_KEY=your_api_key_here
PROJECT_ID=your_project_id
WORKFLOW_ID=your_workflow_id

# Optional (with defaults)
TRELLIS_API_BASE=https://enterprise.training.api.runtrellis.com/v1
REQUEST_TIMEOUT=30
PORT=3000

运行服务

1. 构建并启动容器：

   docker compose up -d

1. 查看日志：

   docker compose logs -f mcp-server

1. 停止容器：

   docker compose down

1. 代码更改后重建：

   docker compose up -d --build

访问服务

运行后，MCP服务器将可在以下位置访问 http://localhost:3000/mcp

Claude桌面配置

要将Claude Desktop连接到此MCP服务器，请更新您的Claude Desktop配置文件：

地点：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

配置：

{
  "mcpServers": {
    "trellis-mcp": {
      "command": "/path/to/your/node/bin/npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3000/mcp"
      ],
      "env": {
        "PATH": "/path/to/your/node/bin:/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin"
      }
    }
  }
}

要求：

• Node.js 20.16.0或更高版本

查找您的npx路径：

which npx

配置示例：

{
  "mcpServers": {
    "trellis-mcp": {
      "command": "/Users/amogh/.nvm/versions/node/v20.16.0/bin/npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3000/mcp"
      ],
      "env": {
        "PATH": "/Users/amogh/.nvm/versions/node/v20.16.0/bin:/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin"
      }
    }
  }
}

更新配置后，重新启动Claude Desktop以使更改生效。

故障排除

• 容器无法启动： 检查日志 docker compose logs mcp-server
• 连接被拒绝： 确保您的主机上尚未使用端口3000
• API错误： 验证您的环境变量是否在 .env 文件
• Claude Desktop无法连接： 确保Docker容器正在运行，并使用验证您的npx路径 which npx