AI导哈

Trello管理服务器

一个将Trello看板、列表和卡片操作暴露为工具的MCP服务器，使AI助手如Claude能够直接管理Trello看板。

  • by concongo
  • Python
  • 混合部署
  • 更新于
在 GitHub 查看 concongo/trello-mcp

使用说明

Trello MCP服务器

一 主控程序 该服务器将Trello板、列表和卡操作作为工具公开，因此像Claude这样的人工智能助手可以直接管理您的Trello板。

内置于 FastMCP, httpx，以及 派丹蒂克.

特性

  • 列出、创建、更新、移动和存档Trello卡
  • 管理检查表和检查项目
  • 创建、分配和删除标签
  • 读取并设置自定义字段值
  • 创建、重命名和存档列表
  • 设定截止日期并标记为完成
  • 浏览公告板和列表
  • 按名称搜索板
  • 在卡片上添加评论
  • 捆绑的Trello API文档作为MCP资源
  • 支持 标准 和 上海证券交易所 运输
  • Docker就绪

先决条件

  • Python 3.12+
  • 紫外线 包管理器
  • 具有API证书的Trello帐户

获取Trello API凭据

  1. 首选https://trello.com/power-ups/admin并登录
  2. 创建新的电源（或使用现有的电源）
  3. 复制您的 API密钥 从开机设置
  4. 生成一个 代币 通过单击同一页面上的令牌链接并授权访问

设置

uv sync --extra dev
cp .env.example .env  # Fill in your Trello API key and token

用法

# stdio transport (default, for MCP clients like Claude Code)
uv run trello-mcp run

# SSE transport (for network access)
uv run trello-mcp run --transport sse --port 8000

码头工人

docker compose up --build

客户端配置

stdio（本地客户端）

客户端将服务器作为子进程生成。将其用于Claude Code、Cursor、Windsurf和类似工具。

克劳德代码 --添加到 .mcp.json （项目）或 ~/.claude.json （全局），或使用CLI：

claude mcp add --transport stdio trello -- \
  uv --directory /absolute/path/to/trello-mcp run trello-mcp run

或手动添加到 .mcp.json:

{
  "mcpServers": {
    "trello": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/trello-mcp", "run", "trello-mcp", "run"],
      "env": {
        "TRELLO_API_KEY": "${TRELLO_API_KEY}",
        "TRELLO_TOKEN": "${TRELLO_TOKEN}"
      }
    }
  }
}

光标 --添加到 .cursor/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "trello": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/trello-mcp", "run", "trello-mcp", "run"],
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_TOKEN": "your-token"
      }
    }
  }
}

开源代码 --添加一个 opencode.json （项目配置）在您的repo根目录中：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "trello": {
      "type": "local",
      "command": ["uv", "--directory", "/absolute/path/to/trello-mcp", "run", "trello-mcp", "run"],
      "enabled": true,
      "environment": {
        "TRELLO_API_KEY": "{env:TRELLO_API_KEY}",
        "TRELLO_TOKEN": "{env:TRELLO_TOKEN}"
      }
    }
  }
}

SSE（网络客户端）

首先启动服务器，然后将客户端指向SSE端点。

# Start the server (or use docker compose up --build)
uv run trello-mcp run --transport sse --port 8000

然后配置您的客户端以连接到 http://localhost:8000/sse.

克劳德代码 --添加到 .mcp.json 或使用CLI：

claude mcp add --transport sse trello http://localhost:8000/sse

或手动：

{
  "mcpServers": {
    "trello": {
      "type": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

光标 --添加到 .cursor/mcp.json:

{
  "mcpServers": {
    "trello": {
      "url": "http://localhost:8000/sse"
    }
  }
}

工具

板子

工具 说明
list_boards 列出经过身份验证的用户的所有板
search_board 按名称子字符串查找电路板

列表

工具 说明
list_lists 在板中列出所有列表
create_list 在板上创建新列表
update_list 更新列表的名称和/或关闭状态
archive_list 存档（关闭）列表

卡片

工具 说明
list_cards 在列表中列出所有卡片
get_board_cards 把所有卡片都放在黑板上
create_card 在列表中创建新卡
move_card 将卡片移动到另一个列表
update_card 更新卡的名称和/或描述
add_comment 在卡片上添加评论
archive_card 将卡片存档（关闭）

截止日期

工具 说明
set_due_date 在卡上设置到期日（ISO 8601）
mark_due_complete 将卡片的到期日标记为完整或不完整

检查清单

工具 说明
get_checklists 把所有清单都写在卡片上
create_checklist 在卡片上创建新的检查表
delete_checklist 删除检查表
add_check_item 将项目添加到检查表中
update_check_item 更新检查项的状态或名称
delete_check_item 从检查表中删除检查项

标签

工具 说明
get_board_labels 将所有标签放在板上
create_label 在电路板上创建新标签
add_label_to_card 为卡片添加标签
remove_label_from_card 从卡片上移除标签

自定义字段

工具 说明
get_custom_fields 获取板上的所有自定义字段定义
set_card_custom_field 在卡片上设置自定义字段值

发展

uv sync --extra dev
uv run pre-commit install
uv run pytest --cov
uv run ruff check . && uv run ruff format --check .

许可证

麻省理工学院

相关 MCP