AI导哈

Trello API服务器

一个提供对Trello API程序化访问的MCP服务器，支持从任何MCP兼容客户端直接管理看板、列表、卡片和组织。

  • by cargom98
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 cargom98/gm-trello-mcp

使用说明

Trello MCP服务器

一种模型上下文协议（MCP）服务器，提供对Trello的API的编程访问。直接从任何兼容MCP的客户端管理板、列表、卡和组织。

快速开始

1.安装

# Using uvx (recommended)
uvx trello-mcp-server

# Using uv
uv tool install trello-mcp-server

# Using pip
pip install trello-mcp-server

2.获取API密钥

访问https://trello.com/power-ups/admin/new并创建一个Power-Up来获取您的API密钥（免费，需要几秒钟）。

3.配置MCP客户端

添加到MCP设置配置文件中：

{
  "mcpServers": {
    "trello": {
      "command": "uvx",
      "args": ["trello-mcp-server"],
      "env": {
        "TRELLO_API_KEY": "your_api_key_here"
      }
    }
  }
}

4.身份验证

首次使用时，服务器会自动打开您的浏览器以授权访问。点击“允许”，你就完成了！

特性

  • 板子：列出并获取董事会详细信息
  • 列表：列出并创建董事会列表
  • 卡片：列出、创建和更新卡片（包括在列表之间移动）
  • 卡会员：添加、删除和列出分配给卡片的成员
  • 卡片标签：添加、删除和列出卡片上的标签
  • 董事会成员：添加、删除、更新和邀请董事会成员
  • 组织：管理工作区、董事会和团队成员

可用工具

董事会管理

  • list_boards -列出所有可访问的板
  • get_board -获取电路板详细信息
  • list_board_lists -将所有列表放在板上
  • list_board_cards -把所有卡片都放在黑板上
  • list_board_labels -在板上列出所有可用标签

列表管理

  • create_list -在板上创建新列表

卡片管理

  • create_card -在列表中创建新卡
  • get_card -获取卡详细信息
  • update_card -更新卡属性（名称、描述、移至列表）

卡会员管理

  • add_card_member -向卡中添加成员
  • remove_card_member -从卡中删除成员
  • list_card_members -列出分配给卡的所有成员

卡片标签管理

  • add_card_label -为卡片添加标签
  • remove_card_label -从卡片上移除标签
  • list_card_labels -列出卡片上的所有标签
  • filter_cards_by_label -按标签在板上过滤卡

董事会成员管理

  • list_board_members -列出所有有权限的董事会成员
  • add_board_member -将现有用户添加到板
  • remove_board_member -从董事会中删除成员
  • update_board_member -更新成员权限级别
  • invite_board_member -通过电子邮件邀请新成员

组织管理

  • list_organizations -列出所有组织/工作区
  • get_organization -获取组织详细信息
  • list_organization_boards -获取组织中的所有董事会
  • list_organization_members -获取所有组织成员
  • add_organization_member -向组织添加成员
  • remove_organization_member -从组织中删除成员

发展

设置

# Quick setup
./setup.sh

# Or manually
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

认证

# Interactive (opens browser)
python -m trello_mcp_server.auth --interactive

# Manual (copy-paste token)
python -m trello_mcp_server.auth --manual

# Check status
python -m trello_mcp_server.auth --check

测试

# Run tests
python -m pytest

# Test organization tools
python test_organizations.py

文档

  • docs/AUTHENTICATION.md -详细的身份验证流程
  • 文档/组织.md -组织管理指南
  • docs/STARTUP_FLOW.md -服务器启动过程
  • docs/FUTURE_FEATURES.md -计划功能
  • 更改日志.md -版本历史

建筑

  • 语言：Python 3.8+
  • 协议：带stdio传输的MCP
  • 认证：OAuth 1.0a，带有自动令牌缓存
  • 令牌存储: ~/.trello_mcp_token.json （600个权限）

安全

  • 存储在MCP配置中的API密钥（可在团队内安全共享）
  • 存储在主目录中的令牌（从未提交）
  • 令牌缓存上的自动文件权限（600）
  • 除非手动撤销，否则令牌永远不会过期

支持

  • 特雷洛API：https://developer.atlassian.com/cloud/trello/
  • 获取API密钥：https://trello.com/power-ups/admin/new
  • 管理令牌：https://trello.com/my/account

贡献

欢迎投稿！请随时提交拉取请求。

开发设置

git clone https://github.com/cargom98/gm-trello-mcp.git
cd gm-trello-mcp
./setup.sh

运行测试

python -m pytest
python test_auth.py
python test_organizations.py

释放

看 发布.md 了解详细的发布说明。

快速发布：

./release.sh

许可证

有关详细信息，请参阅LICENSE文件。

相关 MCP