🚀 MCP 服务器 Trello
MCP 服务器 Trello 是一个模型上下文协议（MCP）服务器，它提供了与 Trello 看板交互的工具。该服务器实现了处理速率限制、类型安全和错误处理的自动化，同时支持与 Trello API 的无缝集成，极大提升了与 Trello 看板交互的效率和稳定性。
🚀 快速开始
你可以按照以下步骤快速将 MCP 服务器 Trello 集成到你的项目中。
✨ 主要特性
- 完整的 Trello 看板集成：可与卡片、列表和看板活动进行交互，实现对 Trello 看板的全面操作。
- 内置速率限制：严格遵循 Trello API 的限制，每个 API 密钥每 10 秒可发起 300 个请求，每个令牌每 10 秒可发起 100 个请求，避免因请求超限导致的问题。
- 类型安全实现：使用 TypeScript 编写，并带有全面的类型定义，确保代码的健壮性和可维护性。
- 输入验证：对所有 API 输入进行稳健验证，防止因非法输入导致的错误。
- 错误处理：具备优雅的错误处理机制，能提供详细的错误信息，方便排查问题。
📦 安装指南
在项目中使用 npm 进行安装：
npm install @modelcontextprotocol/mcp-server-trello
📚 详细文档
配置
将服务器添加到您的 MCP 设置文件中，配置示例如下：
{
"mcpServers": {
"trello": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-trello"],
"env": {
"TRELLO_API_KEY": "你的API密钥", // 获取自 https://trello.com/app-key
"TRELLO_TOKEN": "你的令牌", // 使用你的API密钥生成
"TRELLO_BOARD_ID": "你的看板ID" // 在看板URL中找到
}
}
}
}
必需的环境变量
TRELLO_API_KEY：您的 Trello API 密钥，可从 https://trello.com/app-key 获取。TRELLO_TOKEN：您的 Trello 令牌，需使用您的 API 密钥生成。TRELLO_BOARD_ID：要交互的 Trello 看板 ID，可在看板 URL 中找到。
可用工具
get_cards_by_list_id
根据列表 ID 获取所有卡片。
{
name: 'get_cards_by_list_id',
arguments: {
listId: string // 列表ID
}
}
get_lists
从配置的看板中获取所有列表。
{
name: 'get_lists',
arguments: {}
}
get_recent_activity
获取看板上的最近活动。
{
name: 'get_recent_activity',
arguments: {
limit?: number // 可选：要获取的活动数量（默认：10）
}
}
add_card_to_list
将新卡片添加到指定列表中。
{
name: 'add_card_to_list',
arguments: {
listId: string, // 列表ID
cardData: {
idList: string,
name: string,
desc?: string,
pos?: number,
due?: string,
dueComplete?: boolean,
labels?: string[],
members?: string[],
comments?: {
text: string
}[]
}
}
}
update_card
更新现有卡片的信息。
{
name: 'update_card',
arguments: {
cardId: string, // 卡片ID
cardData: {
idList?: string,
name?: string,
desc?: string,
pos?: number,
due?: string,
dueComplete?: boolean,
labels?: string[],
members?: string[],
comments?: {
text: string
}[]
}
}
}
delete_card
删除指定卡片。
{
name: 'delete_card',
arguments: {
cardId: string // 卡片ID
}
}
速率限制
- 每个 API 密钥每 10 秒：300 个请求
- 每个令牌每 10 秒：100 个请求
📄 许可证
此项目在 MIT License 下许可，详情请参阅LICENSE文件。
💡 贡献
欢迎贡献！请阅读我们的Contributing Guide以了解代码规范和提交拉取请求的过程。