AI导哈

Trello MCP服务器

一个为AI助手提供Trello功能访问的模型上下文协议服务器，使AI模型能够以编程方式与Trello看板、列表和卡片进行交互。

  • by Adise211
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Adise211/trello_mcp_server

使用说明

Trello MCP服务器

一种模型上下文协议（MCP）服务器，为AI助手提供对Trello功能的访问。该服务器使AI模型能够以编程方式与Trello板、列表和卡片进行交互。

先决条件

  • Node.js>=18.0.0
  • npm或yarn包管理器
  • Trello API证书（API密钥和令牌）

安装

  1. 克隆此存储库：
git clone <repository-url>
cd trello_mcp_server
  1. 安装依赖项：
npm install
  1. 构建项目：
npm run build

配置

获取Trello API凭据

要使用此MCP服务器，您需要获取Trello API密钥和令牌。请按照以下步骤操作：

  1. 访问 Trello REST API文档
  2. 按照说明创建Power-Up并生成API凭据
  3. 一旦您拥有API密钥和令牌，您将把它们添加到MCP客户端配置中

MCP客户端配置

这是一个需要在MCP客户端（Cursor或Claude Desktop）中配置的MCP（模型上下文协议）服务器。

对于光标

将以下配置添加到光标MCP设置中：

{
  "mcpServers": {
    "trello-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["<path_to_this_project>/trello_mcp_server/dist/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key",
        "TRELLO_TOKEN": "your_token"
      }
    }
  }
}

适用于克劳德桌面

将以下配置添加到您的Claude Desktop MCP设置中：

{
  "mcpServers": {
    "trello-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["<path_to_this_project>/trello_mcp_server/dist/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key",
        "TRELLO_TOKEN": "your_token"
      }
    }
  }
}

重要提示：

  • 替换 <path_to_this_project> 带有克隆存储库的绝对路径
  • 替换 your_api_key 和 your_token 使用您的真实Trello证书
  • 确保路径指向已编译的 dist/index.js 文件

用法

在MCP客户端（Cursor或Claude Desktop）中配置后，Trello MCP服务器将自动可供AI助手使用。然后，您可以通过自然语言命令与Trello交互，例如：

  • “给我看看我所有的Trello板”
  • “在我的项目板中创建新卡”
  • “将‘修复错误’卡移至‘进行中’列表”
  • “向卡片XYZ添加注释”

与MCP检查器一起使用

要检查和测试MCP服务器：

npm run inspect

API工具参考

电路板工具

工具 说明 参数
get-boards 获取当前用户的所有板 无
get-board-by-name 按名称获取Trello板 name （字符串）
get-board-by-id 按ID获取Trello板 id （字符串）
get-lists-by-board-id 获取特定董事会的所有列表 id （字符串）
get-cards-by-board-id 获取特定板的所有卡 id （字符串）

列出工具

工具 说明 参数
get-list-by-id 按ID获取Trello列表 id （字符串）
get-cards-by-list-id 获取特定列表的所有卡片 id （字符串）

卡片工具

工具 说明 参数
create-card 创建新的Trello卡 name （字符串）， listId （字符串）， desc （字符串，可选）， due （字符串，可选）， labels （数组，可选）
update-card 更新现有的Trello卡 id （字符串）， name （字符串，可选）， desc （字符串，可选）， due （字符串，可选）
delete-card 删除Trello卡 id （字符串）
add-comment-to-card 在卡片上添加评论 id （字符串）， text （字符串）
add-attachment-to-card 在卡片上添加附件 id （字符串）， attachment （文件）
move-card-to-list 将卡片移动到其他列表 id （字符串）， listId （字符串）

示例用法

以下是AI助手如何通过此MCP服务器与Trello交互：

自然语言命令

  • “给我看看我所有的Trello板” → 列出所有可用板
  • “查找‘Project Alpha’板” → 按名称搜索特定董事会
  • “我的项目板上有什么列表？” → 检索板内的所有列表
  • 在“待办事项”列表中创建新的任务卡 → 将新卡添加到特定列表中
  • “更新‘修复错误’卡描述” → 修改现有卡详细信息
  • 将“审查PR”卡移至“完成” → 在列表之间移动卡片
  • “向卡片XYZ添加注释” → 向现有卡片添加注释
  • “删除已完成的ABC卡” → 从板上移除卡

工作流管理

MCP服务器使AI助手能够帮助：

  • 项目跟踪：在工作流程阶段移动卡片
  • 任务管理：创建、更新和组织卡片
  • 团队协作：添加评论和管理卡片分配
  • 董事会组织：构建列表和管理董事会内容

局限性

备注：此MCP服务器目前提供一组有限的Trello工具。随着项目的发展，将添加更多功能。

支持

对于问题和疑问：

  • 检查 Trello API文件
  • 查看项目的问题跟踪器
  • 如果遇到问题，请创建新问题

安全说明

  • 确保API证书的安全，永远不要共享它们
  • 该令牌提供对您的Trello帐户的完全访问权限
  • 定期轮换您的API证书
  • 通过Trello的界面监控您的API使用情况

相关 MCP