Trello MCP Server (TypeScript)

Trello MCP 服务（TypeScript）

用于集成 Trello 的 Model Context Protocol（MCP）服务的 TypeScript 实现，提供供 AI 助手与 Trello 看板、列表和卡片交互的工具。

功能

• 通过 MCP 工具全面集成 Trello API
• 异步操作，提升性能
• 使用 TypeScript 实现类型安全
• 完善的错误处理
• 基于环境变量的配置

前置条件

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

安装

# Install dependencies
make install

配置

在根目录中创建 .env 文件，并填入 Trello 凭据：

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

可用命令

# Install dependencies
make install

# Build the project
make build

# Start the server
make start

# Clean build artifacts
make clean

# Run linter
make lint

MCP 工具

get_boards

获取已认证用户的所有 Trello 看板。

// No input parameters required

get_lists

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

{
  "request": {
    "board_id": string // ID of the board
  }
}

get_cards

获取看板或指定列表中的卡片。

{
  "request": {
    "board_id": string,    // ID of the board
    "list_id"?: string     // Optional: ID of a specific list
  }
}

get_card_details

获取指定卡片的详细信息。

{
  "request": {
    "card_id": string      // ID of the card
  }
}

开发

本项目使用 TypeScript 来确保类型安全并改善开发体验。源代码结构如下：

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

构建

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

# Build the project
make build

# The output will be in the build/ directory

错误处理

本服务针对以下情况实现了完善的错误处理：

• 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 文件