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-server2.获取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文件。