Trello MCP 服务器

Name: Trello MCP Server with Python
Author: m0xai

强大的 MCP 服务器，可通过 AI Hosts 与 Trello 板、列表和卡片进行交互。

先决条件

Python 3.12 或更高版本，可以轻松通过uv进行管理
已安装Claude 桌面版
Trello 帐户和 API 凭据
已安装uv包管理器

预安装

确保您已安装 Claude 桌面应用程序
确保您已经使用您的帐户登录 Claude。
开始克劳德

安装

设置 Trello API 凭证：
- 前往Trello 应用管理
- 在New Power-Up 或 Integration中创建新的集成
- 填写您的信息（您可以将 Iframe 连接器 URL 留空），并确保选择正确的工作区
- 单击您的应用程序图标并从左侧边栏导航到“API 密钥”。
- 复制您的“API密钥”，然后在右侧：“您可以手动生成令牌。”单击单词令牌以获取您的Trello令牌。
将项目根目录中的.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
使用以下命令运行服务器：

python main.py

默认情况下，服务器将在http://localhost:8000上可用（或您配置的端口）

Docker模式

您还可以使用 Docker Compose 运行服务器：

确保已安装 Docker 和 Docker Compose
使用您的配置创建.env文件
构建并启动容器：

docker-compose up -d

服务器默认以 SSE 模式运行
查看日志：

docker-compose logs -f

要停止服务器：

docker-compose down

配置

可以使用.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 中

贡献

请随时提交问题和增强请求！

One-click Deploy

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Tools

View all tools

Trello MCP Server with Python