返回 MCP 目录
public公开dns本地运行

m0xai_trello-mcp-server

Trello MCP服务器是一个通过AI主机与Trello看板、列表和卡片进行交互的强大服务,支持读取、创建、更新和删除操作。

article

README

🚀 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
  1. 安装 uv(若未安装)
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 克隆仓库
git clone https://github.com/m0xai/trello-mcp-server.git
cd trello-mcp-server
  1. 安装依赖项并设置 Claude 服务器
uv run mcp install main.py
  1. 重启 Claude 桌面应用程序

✨ 主要特性

基本功能

| 操作 | 电路板 | 列表 | 卡片 | |------|-------|------|------| | 读取 | ✅ | ✅ | ✅ | | 写入 | ❌ | ✅ | ✅ | | 更新 | ❌ | ✅ | ✅ | | 删除 | ❌ | ✅ | ✅ |

详细功能

电路板操作

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

列表操作

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

卡片操作

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

💻 使用示例

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

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

📚 详细文档

故障排除

如果遇到问题,请检查以下内容:

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

贡献

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

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端