Trello MCP服务器
一种模型上下文协议(MCP)服务器,提供与Trello API交互的工具。
凭据安全地存储在操作系统凭据管理器中,而不是明文文件中。
特性
- 安全凭证存储:存储在操作系统凭据管理器中的凭据(Windows凭据管理器、macOS Keychain或Linux libsecret)
- 无明文秘密:没有
.env文件,没有凭据的环境变量 - Trello集成:完全访问Trello板、列表、卡片等
- API全面覆盖:支持Trello的所有主要业务
- 类型安全:完全支持TypeScript,为Trello对象提供正确的类型
- 错误处理:在整个代码库中进行强大的错误管理
入门指南
先决条件
- Node.js 18或更高版本
- npm
- Trello API密钥和令牌(见下文)
仅限Linux:安装libsecret
# Debian/Ubuntu
sudo apt install libsecret-1-dev
# Fedora
sudo dnf install libsecret-devel
# Arch
sudo pacman -S libsecret安装
- 克隆此存储库:
git clone https://github.com/v4lheru/trello-mcp-server.git
cd trello-mcp-server- 安装依赖项:
npm install- 构建项目:
npm run build- 安全地设置您的凭据:
npm run setup-credentials这将提示您输入Trello API密钥和令牌,然后将它们存储在操作系统凭据管理器中。
要获取您的凭据,请执行以下操作:
1. 首选https://trello.com/app-key 1. 复制API密钥 1. 点击“生成令牌”并复制令牌
用法
启动MCP服务器:
npm start从.env文件迁移
如果您在 .env 文件,安装脚本将自动检测它们:
npm run setup-credentials您将看到:
📁 Found existing credentials in: /path/to/.env
Both API Key and Token found.
Migrate these credentials to secure storage? (Y/n):迁移后,您可以选择从您的 .env 文件。
管理凭据
- 设置/更新凭据:
npm run setup-credentials - 删除凭据:
npm run delete-credentials
凭据存储在:
- 视窗:凭据管理器→ Windows凭据→
trello-mcp-server - macOS:钥匙链访问→
trello-mcp-server - Linux:GNOME钥匙圈/KDE钱包→
trello-mcp-server
Claude桌面配置
添加到您的Claude桌面配置(claude_desktop_config.json):
{
"mcpServers": {
"trello": {
"command": "node",
"args": ["C:/path/to/trello-mcp-server/build/index.js"]
}
}
}可用工具
电路板工具
get_boards-获取已验证用户的所有板get_board-按ID获取特定板create_board-创建新板update_board-更新现有板delete_board-删除板get_board_lists-将所有列表放在板上get_board_members-获取董事会的所有成员get_board_labels-将所有标签放在板上close_board-关闭(存档)一个板reopen_board-重新打开一个封闭的板
列出工具
get_list-按ID获取特定列表create_list-在板上创建新列表update_list-更新现有列表archive_list-存档列表unarchive_list-取消存档列表move_list_to_board-将列表移动到其他板get_cards_in_list-获取列表中的所有卡片archive_all_cards-将所有卡片归档到列表中move_all_cards-将列表中的所有卡片移动到另一个列表
卡片工具
get_card-通过ID获取特定卡create_card-创建新卡update_card-更新现有卡delete_card-删除卡片archive_card-将卡片存档move_card_to_list-将卡片移动到其他列表add_comment-在卡片上添加评论get_comments-在卡片上获取评论add_attachment-在卡片上添加附件get_attachments-在卡上获取附件set_due_date-设置卡片的到期日期set_due_complete-将卡片的到期日标记为完整
成员工具
get_me-获取经过身份验证的成员(当前用户)get_member-通过ID或用户名获取特定成员get_member_boards-获取成员所属的董事会get_member_cards-获取分配给会员的卡片search_members-按姓名搜索成员
标签工具
get_label-按ID获取特定标签create_label-在电路板上创建新标签update_label-更新现有标签delete_label-删除标签add_label_to_card-为卡片添加标签remove_label_from_card-从卡片上移除标签
检查表工具
get_checklist-按ID获取特定清单create_checklist-在卡片上创建新的检查表update_checklist-更新现有检查表delete_checklist-删除检查表get_checkitems-获取检查表上的所有检查项create_checkitem-在检查表上创建新的检查项update_checkitem-更新检查表上的检查项delete_checkitem-从检查表中删除检查项
安全
凭据存储在您的操作系统凭据管理器(Windows凭据管理器、macOS Keychain或Linux libsecret)中,并使用您的登录凭据进行加密。
许可证
该项目根据MIT许可证获得许可。
