Trello MCP 服务器
强大的 MCP 服务器，可通过 AI Hosts 与 Trello 板、列表和卡片进行交互。
目录
先决条件
- Python 3.12 或更高版本，可以轻松通过
uv进行管理 - 已安装Claude 桌面版
- Trello 帐户和 API 凭据
- 已安装uv包管理器
预安装
- 确保您已安装 Claude 桌面应用程序
- 确保您已经使用您的帐户登录 Claude。
- 开始克劳德
安装
- 设置 Trello API 凭证：
- 将项目根目录中的
.env.example文件重命名为.env并设置刚刚获得的变量：
TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here
- 如果尚未安装 uv，请安装：
curl -LsSf https://astral.sh/uv/install.sh | sh
- 克隆此存储库：
git clone https://github.com/m0xai/trello-mcp-server.git
cd trello-mcp-server
- 安装依赖项并使用 uv:: 为 Claude 设置服务器
uv run mcp install main.py
- 重启 Claude 桌面应用程序
服务器模式
该 MCP 服务器可以以两种不同的模式运行：
克劳德应用模式
此模式直接与 Claude Desktop 应用程序集成：
- 在你的
.env文件中设置USE_CLAUDE_APP=true （这是默认值） - 使用以下命令运行服务器：
uv run mcp install main.py
- 重新启动 Claude Desktop 应用程序
SSE 服务器模式
此模式作为独立的 SSE 服务器运行，可与任何与 MCP 兼容的客户端一起使用，包括 Cursor：
- 在
.env文件中设置USE_CLAUDE_APP=false - 使用以下命令运行服务器：
- 默认情况下，服务器将在
http://localhost:8000上可用（或您配置的端口）
Docker模式
您还可以使用 Docker Compose 运行服务器：
- 确保已安装 Docker 和 Docker Compose
- 使用您的配置创建
.env文件 - 构建并启动容器：
- 服务器默认以 SSE 模式运行
- 查看日志：
- 要停止服务器：
配置
可以使用.env文件中的环境变量来配置服务器：
| 多变的 | 描述 | 默认 |
|---|
| TRELLO_API_KEY | 您的 Trello API 密钥 | 必需的 |
| TRELLO_TOKEN | 您的 Trello API 令牌 | 必需的 |
| MCP_服务器名称 | MCP 服务器的名称 | Trello MCP 服务器 |
| MCP_服务器_主机 | SSE 模式的主机地址 | 0.0.0.0 |
| MCP_服务器端口 | SSE 模式的端口 | 8000 |
| USE_CLAUDE_APP | 是否使用Claude应用模式 | 真的 |
您可以通过在.env文件中编辑这些值来自定义服务器。
客户端集成
与 Claude Desktop 一起使用
- 以 Claude 应用模式运行服务器（
USE_CLAUDE_APP=true ） - 启动或重新启动 Claude Desktop
- Claude 将自动检测并连接到您的 MCP 服务器
与游标一起使用
要将 MCP 服务器连接到 Cursor：
- 以 SSE 模式运行服务器（
USE_CLAUDE_APP=false ） - 在 Cursor 中，前往“设置”（齿轮图标）> AI > 模型上下文协议
- 添加一个新服务器，URL 为
http://localhost:8000 （或您配置的主机/端口） - 使用 Cursor 的 AI 功能时选择服务器
您还可以将此配置添加到 Cursor 设置 JSON 文件（通常位于~/.cursor/mcp.json ）：
{
"mcpServers": {
"trello": {
"url": "http://localhost:8000/sse"
}
}
}
与其他 MCP 客户端一起使用
对于其他与 MCP 兼容的客户端，请将它们指向http://localhost:8000 SSE 端点。
最小客户端示例
下面是连接到 SSE 端点的最小 Python 示例：
import asyncio
import httpx
async def connect_to_mcp_server():
url = "http://localhost:8000/sse"
headers = {"Accept": "text/event-stream"}
async with httpx.AsyncClient() as client:
async with client.stream("GET", url, headers=headers) as response:
# Get the session ID from the first SSE message
session_id = None
async for line in response.aiter_lines():
if line.startswith("data:"):
data = line[5:].strip()
if "session_id=" in data and not session_id:
session_id = data.split("session_id=")[1]
# Send a message using the session ID
message_url = f"http://localhost:8000/messages/?session_id={session_id}"
message = {
"role": "user",
"content": {
"type": "text",
"text": "Show me my Trello boards"
}
}
await client.post(message_url, json=message)
if __name__ == "__main__":
asyncio.run(connect_to_mcp_server())
功能
| 手术 | 木板 | 列表 | 卡片 | 清单 | 核对清单项目 |
|---|
| 读 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 写 | ❌ | ✅ | ✅ | ✅ | ✅ |
| 更新 | ❌ | ✅ | ✅ | ✅ | ✅ |
| 删除 | ❌ | ✅ | ✅ | ✅ | ✅ |
详细功能
董事会运作
列表操作
- ✅ 阅读看板中的所有列表
- ✅ 阅读具体列表详情
- ✅ 创建新列表
- ✅ 更新列表名称
- ✅ 存档（删除）列表
卡片操作
- ✅ 阅读列表中的所有卡片
- ✅ 阅读具体的卡详细信息
- ✅ 创建新卡片
- ✅ 更新卡牌属性
- ✅ 删除卡片
核对清单操作
- ✅ 获取具体清单
- ✅ 在卡片中列出所有清单
- ✅ 创建新的清单
- ✅ 更新清单
- ✅ 删除清单
- ✅ 将检查项添加到清单
- ✅ 更新检查项目
- ✅ 删除勾选项
用法
安装完成后，您可以通过 Claude 与 Trello 看板进行交互。以下是一些示例查询：
- “显示我的所有图板”
- “[board_name] 版块中有哪些列表？”
- “在列表 [list_name] 中创建一张新卡片，标题为 [title]”
- “更新卡牌 [card_name] 的描述”
- “归档列表 [list_name]”
以下是我的示例用法：
故障排除
如果您遇到问题：
- 在
.env文件中验证您的 Trello API 凭据 - 检查您在 Trello 工作区中是否拥有适当的权限
- 确保 Claude for Desktop 运行的是最新版本
- 使用
uv run mcp dev main.py命令检查日志中是否有任何错误消息。 - 确保 uv 已正确安装并位于你的 PATH 中
贡献
请随时提交问题和增强请求！