看板麦普服务器

Name: 看板麦普服务器
Author: m0xai

作者：m0xai41 星标更新：2025-08-01

安装使用来源：spider==github.com

项目介绍

Trello MCP Server

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

前置条件

Python 3.12或更高版本，可通过uv轻松管理
安装Claude桌面应用
Trello账户及API凭证
安装uv包管理器

安装前准备

确保已安装Claude桌面应用
确保已使用您的账户登录Claude
启动Claude

安装

设置Trello API凭证：
- 访问Trello应用管理
- 在新建Power-Up或集成创建一个新的集成
- 填写信息（Iframe连接器URL可以留空），确保选择正确的Workspace
- 点击您的应用图标，并从左侧边栏导航到“API密钥”
- 复制您的“API密钥”，并在右侧点击“手动生成Token”来获取Trello Token。
将项目根目录中的.env.example文件重命名为.env并设置您刚刚获取的变量：

TRELLO_API_KEY=您的API密钥
TRELLO_TOKEN=您的Token

如果尚未安装，请安装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应用模式

此模式直接与Claude桌面应用程序集成：

在您的.env文件中设置USE_CLAUDE_APP=true（这是默认值）
使用以下命令运行服务器：

uv run mcp install main.py

重启Claude桌面应用

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_SERVER_NAME	MCP服务器名称	Trello MCP Server
MCP_SERVER_HOST	SSE模式下的主机地址	0.0.0.0
MCP_SERVER_PORT	SSE模式下的端口	8000
USE_CLAUDE_APP	是否使用Claude应用模式	true

您可以根据需要编辑这些值以自定义服务器。

客户端集成

与Claude桌面应用配合使用

在Claude应用模式下运行服务器（USE_CLAUDE_APP=true）
启动或重启Claude桌面应用
Claude将自动检测并连接到您的MCP服务器

与Cursor配合使用

要将您的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的客户端，指向SSE端点http://localhost:8000。

最小客户端示例

这是一个最小的Python示例，用于连接到SSE端点：

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:
            # 从第一个SSE消息中获取会话ID
            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]
                        
                        # 使用会话ID发送消息
                        message_url = f"http://localhost:8000/messages/?session_id={session_id}"
                        message = {
                            "role": "user",
                            "content": {
                                "type": "text",
                                "text": "显示我的Trello看板"
                            }
                        }
                        await client.post(message_url, json=message)

if __name__ == "__main__":
    asyncio.run(connect_to_mcp_server())

功能

操作	看板	列表	卡片	检查清单	检查清单项
读取	✅	✅	✅	✅	✅
写入	❌	✅	✅	✅	✅
更新	❌	✅	✅	✅	✅
删除	❌	✅	✅	✅	✅

详细功能

看板操作

✅ 读取所有看板
✅ 读取特定看板详情

列表操作

✅ 读取看板中的所有列表
✅ 读取特定列表详情
✅ 创建新列表
✅ 更新列表名称
✅ 归档（删除）列表

卡片操作

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

检查清单操作

✅ 获取特定检查清单
✅ 列出卡片中的所有检查清单
✅ 创建新的检查清单
✅ 更新检查清单
✅ 删除检查清单
✅ 向检查清单添加检查项
✅ 更新检查项
✅ 删除检查项

使用方法

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

"显示我所有的看板"
"看板[看板名称]有哪些列表？"
"在列表[list_name]中创建一个标题为[标题]的新卡片"
"更新卡片[卡片名称]的描述"
"归档列表[list_name]"

这里是几个示例用法：

故障排除

如果您遇到问题：

核实.env文件中的Trello API凭证
确认您在Trello工作区中有适当的权限
确保Claude桌面应用是最新版本
使用uv run mcp dev main.py命令检查日志中的错误信息。
确保uv已正确安装并添加到PATH中

贡献

欢迎提交问题和改进请求！