Trello MCP 服务器 (TypeScript)

用于 Trello 集成的模型上下文协议 (MCP) 服务器的 TypeScript 实现，为 AI 助手提供与 Trello 板、列表和卡片交互的工具。

特征

• 通过 MCP 工具实现完整的 Trello API 集成

• 异步操作以获得更好的性能

• 使用 TypeScript 的类型安全实现

• 全面的错误处理

• 基于环境的配置

Related MCP server: Claude MCP Trello

先决条件

• Node.js 18.x 或更高版本

• npm 或 yarn

• Trello API 凭证

安装

# Install dependencies
make install

配置

使用您的 Trello 凭据在根目录中创建一个.env文件：

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 工具

获取板

检索经过身份验证的用户的所有 Trello 板。

// No input parameters required

获取列表

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

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

获取卡片

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

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

获取卡片详情

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

{
  "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. 分叉存储库

2. 创建你的功能分支（ git checkout -b feature/amazing-feature ）

3. 提交您的更改（ git commit -m 'Add some amazing feature' ）

4. 推送到分支（ git push origin feature/amazing-feature ）

5. 打开拉取请求

与 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 许可证 - 详情请参阅许可证文件