Trello MCP 服务器 (TypeScript)

这是一个使用 TypeScript 实现的 Model Context Protocol (MCP) 服务器，用于 Trello 集成，为 AI 助手提供与 Trello 看板、列表和卡片交互的工具。

功能

• 通过 MCP 工具完整集成 Trello API
• 异步操作以获得更好的性能
• 使用 TypeScript 的类型安全实现
• 完善的错误处理
• 基于环境的配置

前提条件

• Node.js 18.x 或更高版本
• npm 或 yarn
• Trello API 凭据

安装

# 安装依赖
make install

配置

在根目录下创建一个 .env 文件，并填入您的 Trello 凭据：

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

可用命令

# 安装依赖
make install

# 构建项目
make build

# 启动服务器
make start

# 清理构建产物
make clean

# 运行 linter
make lint

MCP 工具

get_boards

检索已验证用户的所有 Trello 看板。

// 无需输入参数

get_lists

从指定的看板获取所有列表。

{
  "request": {
    "board_id": string // 看板的 ID
  }
}

get_cards

从看板或特定列表获取卡片。

{
  "request": {
    "board_id": string,    // 看板的 ID
    "list_id"?: string     // 可选：特定列表的 ID
  }
}

get_card_details

检索有关特定卡片的详细信息。

{
  "request": {
    "card_id": string      // 卡片的 ID
  }
}

开发

该项目使用 TypeScript 来保证类型安全和更好的开发者体验。 源代码组织如下：

• src/index.ts - 主服务器入口点
• src/trello-client.ts - Trello API 客户端实现
• src/types.ts - TypeScript 类型定义

构建

该项目使用 TypeScript 编译器进行构建：

# 构建项目
make build

# 输出将在 build/ 目录中

错误处理

服务器实现了全面的错误处理，包括：

• API 身份验证错误
• 速率限制
• 网络问题
• 无效的请求参数

贡献

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

与 Cline 一起使用

要将此 MCP 服务器与 Cline 一起使用，请将以下配置添加到您的 Cline MCP 设置文件 (~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json)：

{
  "mcpServers": {
    "trello-ts": {
      "command": "node",
      "args": ["/path/to/mcp-server-ts-trello/build/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key",
        "TRELLO_TOKEN": "your_token"
      }
    }
  }
}

添加配置并重启 Cline 后，您可以使用以下 MCP 工具：

• get_boards: 列出所有 Trello 看板
• get_lists: 从看板获取列表
• get_cards: 从看板或列表获取卡片
• get_card_details: 获取详细的卡片信息

许可证

ISC 许可证 - 有关详细信息，请参见 LICENSE 文件