AI导哈

Trello MCP服务器

一个全面的Trello看板管理模型上下文协议（MCP）服务器，为AI助手提供通过自然语言命令与Trello看板、列表和卡片交互的强大工具。

  • by enoteware
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 enoteware/trello-mcp-server

使用说明

Trello MCP 服务器

一个全面的Trello看板管理模型上下文协议（MCP）服务器。该服务器为像Claude这样的AI助手提供了强大的工具，使其能够通过自然语言指令与Trello看板、列表和卡片进行交互。

特点/特性

🎯（瞄准目标） 完成Trello集成

  • 列出所有可访问的板卡
  • 从任意看板中获取列表和卡片
  • 创建、更新和移动卡片
  • 完成后存档卡片
  • 查看最近的论坛活动

🔒（锁形符号，常用于表示安全、保密或锁定状态） 安全可靠

  • 基于环境的身份验证
  • 全面的错误处理
  • 尊重Trello API的速率限制
  • 输入验证和清理

🚀（火箭/快速上升的箭头，常用于表示快速进展、进步或发射等） 易于使用

  • 简单的环境变量配置
  • 清除错误信息并进行调试
  • 兼容Claude Code及其他MCP客户端
  • 详尽的文档和示例

安装

选项1：NPM全局安装（推荐）

npm install -g trello-mcp-server

选项2：克隆并安装

git clone https://github.com/enoteware/trello-mcp-server.git
cd trello-mcp-server
npm install

配置

  1. 获取Trello API凭证：

    • API密钥：访问https://trello.com/app-key
    • 令牌：访问授权URL（见下文）

  2. 生成令牌： 替换 YOUR_API_KEY 使用您的实际API密钥：

    https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Trello%20MCP%20Server&key=YOUR_API_KEY

  3. 配置环境：

    cp .env.example .env
# Edit .env with your credentials

  4. 环境变量：

    TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here
TRELLO_BOARD_ID=your_default_board_id  # Optional

每个项目的环境文件

这台服务器将自动从（某个位置）加载环境变量 .env.local 如果当前工作目录中存在该文件，则使用该文件；否则，回退到 .env这允许你在每个项目中保存凭据，而无需将其提交到版本控制中。请将这些文件排除在版本控制之外。

优先顺序：

  • .env.local（最高优先级）
  • `.env` 文件（或简称为 `.env`）
  • 已设置的进程环境变量（来自shell、Docker或MCP配置）

使用方法

独立服务器

npm start
# or if installed globally:
trello-mcp-server

与克劳德·科德一起

在您的Claude Code MCP配置中添加：

{
  "trello": {
    "command": "trello-mcp-server",
    "env": {
      "TRELLO_API_KEY": "your_api_key",
      "TRELLO_TOKEN": "your_token",
      "TRELLO_BOARD_ID": "your_board_id"
    }
  }
}

可用工具

get_boards

列出您帐户可以访问的所有Trello看板。

示例： “显示我的所有Trello看板”

get_lists

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

参数：

  • boardId （可选）：看板ID，如未提供则使用TRELLO_BOARD_ID

示例： “我的项目看板里有哪些列表？”

get_cards

获取特定列表中的所有卡片。

参数：

  • listId （必填）：要从中获取卡片的列表ID

示例： “显示‘待办事项’列表中的所有卡片”

create_card

在列表中创建一张新卡片。

参数：

  • listId （必填）：要在其中创建卡片的列表ID
  • name （必填）：卡片标题
  • desc （可选）：卡片描述
  • pos （可选）：位置（'top'、'bottom' 或数字）

示例： “在待办事项列表中创建一个名为‘修复登录错误’的卡片”

update_card

更新现有卡片。

参数：

  • cardId （必填）：要更新的卡片ID
  • name （可选）：新卡片标题
  • desc （可选）：新卡片描述

示例： “更新卡片描述，加入复现该错误的步骤”

move_card

将卡片移动到另一个列表。

参数：

  • cardId （必填）：要移动的卡片ID
  • listId （必填）：目标列表ID
  • pos （可选）：在目标列表中的位置

示例： “将这张卡片移到‘进行中’列表”

archive_card

存档（关闭）一张卡片。

参数：

  • cardId （必填）：要存档的卡片ID

示例： “将此已完成任务存档”

get_board_activity

获取看板上的最新活动。

参数：

  • boardId （可选）：看板ID，如未提供，则使用TRELLO_BOARD_ID
  • limit （可选）：活动数量（默认：10，最大：50）

示例： “显示我项目看板上的最新活动”

示例对话

创建项目任务：

用户：“在我的开发板待办事项列表中创建一个名为‘实现用户认证’的新卡片”

助手：我会为您创建那张卡片。让我先获取您的看板列表，然后创建卡片。

管理工作流程：

用户：“将所有卡片从‘审核中’移动到‘已完成’，并显示更新后的看板活动”

助手：我会帮你移动那些卡片并展示活动。首先，让我从你的“待审核”列表中获取这些卡片。

项目状态检查：

用户：“我的项目当前状态如何？请展示给我所有列表和最新活动。”

助理：我将为您提供一个包含所有列表和最近董事会活动的完整项目概述。

发展

本地开发

git clone https://github.com/enoteware/trello-mcp-server.git
cd trello-mcp-server
npm install
npm run dev  # Runs with --watch for auto-restart

测试

# Test the server
npm start

# In another terminal, test with MCP client
# or use with Claude Code

故障排除

认证问题

  • 验证您的API密钥是否正确
  • 确保您的令牌具有读/写权限
  • 检查您的令牌是否已过期
  • 确保你使用的是正确的Trello账户

未找到板/列表

  • 验证板/列表ID是否正确
  • 确认您能访问该董事会
  • 使用 get_boards 查看可用的板块

速率限制

  • 服务器遵守Trello的速率限制
  • 如果你遇到了限制，请稍等片刻后再重试
  • 考虑降低请求的频率

API 限制

Trello API 有以下限制：

  • 根据每10秒每个API密钥300次请求
  • 每秒10秒内每个令牌可处理100个请求

服务器会以优雅的方式处理这些限制，并提供适当的错误信息。

贡献；助力

  1. 为仓库创建分支（或“克隆仓库”）
  2. 创建一个特性分支
  3. 进行你的更改
  4. 如适用，请添加测试
  5. 提交一个拉取请求

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

支持

  • 在GitHub上创建一个关于错误或功能请求的问题
  • 检查现有问题中的常见问题
  • 请参阅Trello的API文档以了解高级用法

为MCP生态系统倾注爱心打造

相关 MCP