Trello MCP 服务器（TypeScript）

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

功能特性

• 完全集成 Trello API 的 MCP 工具
• 异步操作以实现更好的性能
• 使用 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

# 运行代码检查工具
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

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

{
  "mcp_servers": {
    "trello_server": {
      "url": "http://localhost:3000",
      "type": "trello"
    }
  },
  "default_mcp_server": "trello_server"
}

许可证

此项目使用 ISC 许可证。请查看 LICENSE 文件以获取详细信息。