AI导哈

MCP协议服务器

基于TypeScript的MCP协议服务器，集成Trellis API，用于模型上下文协议处理。

  • by 0xamogh
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 0xamogh/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

  2. 查看日志：

    docker compose logs -f mcp-server

  3. 停止容器：

    docker compose down

  4. 代码更改后重建：

    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

相关 MCP