M0xai Trello MCP Server

🚀 Trello MCP 服务器

Trello MCP 服务器是一个强大的多协议客户端服务器（MCP），借助 AI 主机，可实现与 Trello 的电路板、列表和卡片进行交互，为您的 Trello 使用体验带来更多便利。

🚀 快速开始

在使用 Trello MCP 服务器之前，您需要完成一系列的准备和安装步骤。

先决条件

1. 需安装 Python 3.12 或更高版本，可通过 uv 轻松管理。
2. 已安装 Claude for Desktop。
3. 拥有 Trello 账户和 API 凭证。
4. 已安装 uv 包管理器。

安装前准备

1. 确保已安装 Claude 桌面应用程序。
2. 使用您的账户登录到 Claude。
3. 启动 Claude。

安装步骤

1. 设置 Trello API 凭证：
   • 访问 Trello Apps Administration。
   • 在 新建 Power - Up 或 Integration 创建一个新的集成。
   • 填写相关信息（可留空 Iframe 连接 URL），并确保选择正确的 Workspace。
   • 点击您的应用程序图标，从左侧边栏导航到 "API key"。
   • 复制获取的 "TRELLO_API_KEY"，并在右侧点击 "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. 安装依赖项并设置 Claude 服务器：

uv run mcp install main.py

6. 重启 Claude 桌面应用程序

✨ 主要特性

基本功能

详细功能

电路板操作

• ✅ 读取所有电路板
• ✅ 读取特定电路板的详细信息

列表操作

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

卡片操作

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

💻 使用示例

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

• "显示我的所有电路板"
• "[电路板名称] 的列表是什么？"
• "在 [列表名称] 中创建新卡片"
• "更新 [卡片名称] 的详细信息"
• "删除 [卡片名称]"

📚 详细文档

故障排除

如果遇到问题，请检查以下内容：

1. 确保所有依赖项已正确安装。
2. 验证 API 凭证是否有效。
3. 检查控制台是否有错误消息。
4. 如仍有问题，参考文档或联系支持团队。

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解如何参与。