Trello MCP 服务器

一个强大的 MCP 服务器，用于通过 AI Host 与 Trello 看板、列表和卡片进行交互。

目录

• 目录
• 前提条件
• 预安装
• 安装
• 功能
• 详细功能
  • 看板操作
  • 列表操作
  • 卡片操作
• 用法
• 故障排除
• 贡献

前提条件

1. Python 3.12 或更高版本，可以使用 uv 轻松管理
2. 安装 Claude for Desktop
3. Trello 帐户和 API 凭据
4. 安装 uv 包管理器

预安装

1. 确保您已安装 Claude Desktop App
2. 确保您已使用您的帐户登录 Claude。
3. 启动 Claude

安装

1. 设置 Trello API 凭据：

   • 转到 Trello Apps Administration
   • 在 New Power-Up or Integration 创建一个新的集成
   • 填写您的信息（您可以将 Iframe 连接器 URL 留空），并确保选择正确的工作区
   • 点击您的应用程序图标，然后从左侧边栏导航到“API key”。
   • 复制您的“API key”，然后在右侧：“you can manually generate a Token.” 点击单词 token 以获取您的 Trello Token。

2. 将项目根目录中的 .env.example 文件重命名为 .env，并设置您刚刚获得的变量：

TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here

3. 如果您尚未安装 uv，请安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

4. 克隆此存储库：

git clone https://github.com/m0xai/trello-mcp-server.git
cd trello-mcp-server

5. 使用 uv 安装依赖项并为 Claude 设置服务器：

uv run mcp install main.py

6. 重新启动 Claude Desktop app

功能

操作	看板	列表	卡片
读取	✅	✅	✅
写入	❌	✅	✅
更新	❌	✅	✅
删除	❌	✅	✅

详细功能

看板操作

• ✅ 读取所有看板
• ✅ 读取特定看板详细信息

列表操作

• ✅ 读取看板中的所有列表
• ✅ 读取特定列表详细信息
• ✅ 创建新列表
• ✅ 更新列表名称
• ✅ 存档（删除）列表

卡片操作

• ✅ 读取列表中的所有卡片
• ✅ 读取特定卡片详细信息
• ✅ 创建新卡片
• ✅ 更新卡片属性
• ✅ 删除卡片

用法

安装完成后，您可以通过 Claude 与您的 Trello 看板进行交互。 以下是一些示例查询：

• "Show me all my boards" (显示我的所有看板)
• "What lists are in board [board_name]?" (看板 [board_name] 中有哪些列表？)
• "Create a new card in list [list_name] with title [title]" (在列表 [list_name] 中创建一个标题为 [title] 的新卡片)
• "Update the description of card [card_name]" (更新卡片 [card_name] 的描述)
• "Archive the list [list_name]" (存档列表 [list_name])

故障排除

如果您遇到问题：

1. 验证 .env 文件中的 Trello API 凭据
2. 检查您在 Trello 工作区中是否具有适当的权限
3. 确保 Claude for Desktop 正在运行最新版本
4. 使用 uv run mcp dev main.py 命令检查日志中是否有任何错误消息。
5. 确保 uv 已正确安装并在您的 PATH 中

贡献

欢迎提交问题和增强请求！