AI导哈

Trello API 集成服务器

一个提供安全凭证存储和完整Trello API集成的服务器工具，适用于需要安全访问和管理Trello看板的开发场景。

  • by v4lheru
  • TypeScript
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 v4lheru/trello-mcp-server

使用说明

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

安装

  1. 克隆此存储库：

    git clone https://github.com/v4lheru/trello-mcp-server.git
cd trello-mcp-server

  2. 安装依赖项：

    npm install

  3. 构建项目：

    npm run build

  4. 安全地设置您的凭据:

    npm run setup-credentials

    这将提示您输入Trello API密钥和令牌，然后将它们存储在操作系统凭据管理器中。

    要获取您的凭据，请执行以下操作：

    1. 首选https://trello.com/app-key
    2. 复制API密钥
    3. 点击“生成令牌”并复制令牌

用法

启动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许可证获得许可。

相关 MCP