使用说明

🎯 Trello MCP服务器

通过模型上下文协议为Claude桌面提供强大的Trello集成

安装 • 功能 • 配置 • 使用 • 文档

📖 关于

Trello MCP服务器是一个服务器模型上下文协议这允许Claude Desktop和其他MCP兼容应用程序直接与Trello API交互。用自然语言管理您的董事会、列表和卡片！

✨ 为什么是这个项目？

🤖 自然自动化 ：请Claude为您管理Trello
🔒 安全 ：您的凭证仍然是本地的
⚡ 速度 ：TypeScript编译以获得最佳性能
🎨 灵活的 ：33个工具，涵盖所有基本需求
🏗️ 现代建筑 ：模式工厂+注册表，实现最佳可维护性（v2.0.0）

🚀 功能

📊 董事会管理（2个输出）

输出	描述
`list_trello_boards`	列出所有Trello板
`create_trello_board`	创建新董事会

📝 列表格式（2个输出）

输出	描述
`list_trello_lists`	列出董事会的列
`create_trello_list`	创建新列

🎯 卡片格式（11张）

输出	描述
`list_trello_cards`	从列表中列出卡片
`create_trello_card`	创建新地图
`add_card_comment`	添加评论
`move_trello_card`	在列表之间移动地图
`search_trello_cards`	卡特研究
`update_card_description`	修改描述
`update_card_name`	更改卡的名称
`get_card_details`	地图的完整详细信息
`archive_card`	存档地图（可逆）
`unarchive_card`	取消存档地图
`delete_card`	永久删除⚠️

🏷️ 标签格式（5页）

输出	描述
`list_labels`	列出板上的所有标签
`create_label`	创建新标签
`update_label`	修改已存在的未标签
`add_label_to_card`	向卡添加标签
`remove_label_from_card`	从卡中删除标签

📅 日期格式（4页）

输出	描述
`set_card_due_date`	设置截止日期
`remove_card_due_date`	删除截止日期
`mark_due_date_complete`	将日期标记为已完成
`list_cards_by_due_date`	按日期排序的卡片列表

✅ 检查表格式（5份）

输出	描述
`add_checklist_to_card`	创建新的检查表
`add_checklist_item`	将项目添加到检查表
`check_checklist_item`	勾选/取消勾选项目
`get_checklist_progress`	获取详细进度
`delete_checklist`	删除检查表⚠️

👥 备忘录（4页）

输出	描述
`get_board_members` 列出董事会的所有成员
`add_member_to_card`	将成员分配给卡
`remove_member_from_card`	撤销成员的分配
`get_member_cards`	列出分配给成员的卡

📦 安装

🚀 使用MCPB捆绑包快速安装（推荐）

Claude桌面一键安装！

下载捆绑包 : Trello_MCP.mcpb （3.0 MB）
安装程序 :
- 选项A ：双击文件 .mcpb （macOS/Windows）
- 选项B ：丹斯·克劳德桌面→ 设置→ 扩展→ 高级→ 从文件安装
Trello配置vos凭据 :
- API密钥：Obtenir surhttps://trello.com/power-ups/admin
- 令牌API：单击“令牌”并允许读/写权限
这是吹牛！ 🎉 MCP服务器已安装并准备使用。

核查 :

"Liste tous mes boards Trello" → Claude affiche vos boards

🛠️ 手动安装（开发人员）

先决条件 :

Node.js 18岁或以上
npm 哦纱线
一个帐户特雷洛

步骤 :

# Cloner le repository
git clone https://github.com/JulianKerignard/Trello_MCP.git
cd Trello_MCP

# Installer les dépendances
npm install --production

# Compiler le projet
npm run build

🔑 配置

步骤1：获取Trello凭证

Rendez voushttps://trello.com/power-ups/admin
创建电源（如有必要）
点击 “生成新的API密钥”
注意你的 API密钥 📝
点击 “令牌” 为了生成 API代币
授予权限读和写
注意你的代币 📝

步骤2：设置凭证

选项A：.env文件（本地开发）

cp .env.example .env

编辑 .env 并添加您的凭据：

TRELLO_API_KEY=votre_api_key_ici
TRELLO_API_TOKEN=votre_token_ici

选项B：克劳德桌面（推荐）

编辑配置文件：

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
视窗 : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": [
        "/chemin/absolu/vers/trello-mcp-server/build/index.js"
      ],
      "env": {
        "TRELLO_API_KEY": "votre_api_key",
        "TRELLO_API_TOKEN": "votre_token"
      }
    }
  }
}

⚠️ 重要：使用 绝对化学 朝向 build/index.js

步骤3：重新启动Claude桌面

关闭并重新启动Claude Desktop以加载MCP服务器。

💬 使用

Claude桌面示例

Vous : "Liste tous mes boards Trello"
Claude : [Utilise list_trello_boards et affiche vos boards]

Vous : "Crée un board 'Projet Marketing' avec 3 lists : Backlog, En cours, Terminé"
Claude : [Crée automatiquement le board et les 3 lists]

Vous : "Ajoute une carte 'Rédiger article blog' dans To Do avec une description"
Claude : [Crée la carte avec la description demandée]

Vous : "Déplace la carte 'Task X' vers Done"
Claude : [Déplace la carte automatiquement]

Vous : "Archive toutes les cartes terminées"
Claude : [Archive les cartes identifiées]

Vous : "Cherche les cartes qui contiennent 'bug'"
Claude : [Recherche et affiche les résultats]

⚠️ 存档管理与删除

✅ RECOMMANDÉ : Archiver d'abord
Vous : "Archive la carte 'Ancienne tâche'"
→ Carte archivée (réversible)

⚠️ ATTENTION : Suppression définitive
Vous : "Supprime définitivement la carte 'Spam'"
→ Carte supprimée (IRRÉVERSIBLE)

💡 Workflow optimal :
1. Archiver les cartes terminées
2. Vérifier après quelques jours
3. Supprimer seulement si vraiment inutile

🛠️ 发展

项目结构（v2.0.0-架构处理程序注册表）

trello-mcp-server/
├── src/
│   ├── index.ts                      # Point d'entrée (175 lignes, -90% vs v1.x)
│   ├── trello-client.ts              # Client API Trello avec gestion d'erreurs
│   ├── types.ts                      # Définitions TypeScript principales
│   ├── logger.ts                     # Configuration Pino logging
│   └── handlers/                     # 🆕 Architecture modulaire (v2.0.0)
│       ├── types.ts                  # Interfaces ToolHandler, ValidationRule
│       ├── base-handler.ts           # Classe abstraite avec validation
│       ├── tool-registry.ts          # Registre central (Map-based)
│       ├── index.ts                  # Registration des 33 handlers
│       ├── boards-handlers.ts        # 2 handlers boards
│       ├── lists-handlers.ts         # 2 handlers lists
│       ├── cards-handlers.ts         # 11 handlers cards
│       ├── labels-handlers.ts        # 5 handlers labels
│       ├── dates-handlers.ts         # 4 handlers dates
│       ├── checklists-handlers.ts    # 5 handlers checklists
│       └── members-handlers.ts       # 4 handlers members
├── build/                            # Code JavaScript compilé
├── .env.example                      # Template pour les variables d'environnement
├── tsconfig.json                     # Configuration TypeScript
├── package.json                      # Dépendances et scripts
├── CHANGELOG.md                      # Historique des versions
└── README.md

🎯 v2.0.0体系结构的优势 :

✅ 可维护性 ：每个域的模块化代码（板、卡、标签等）
✅ 可扩展性 ：添加新工具而不更改index.ts
✅ 类型安全 ：通用TypeScript <TArgs, TResult>
✅ 集中验证 ：声明性ValidationRule
✅ 演出：通过Map查找O（1）（与33 if语句相比）
✅ 不要重复自己 ：重复约70%→ ~5%

可用脚本

# Build & Développement
npm run build         # Compile TypeScript → JavaScript
npm run watch         # Compile en mode watch (développement)
npm run dev           # Build + démarre le serveur
npm run inspector     # Démarre avec MCP Inspector (debug)
npm start             # Démarre le serveur (requiert build préalable)

# Tests & Qualité (v2.0.0)
npm test              # Execute les tests unitaires (36 tests)
npm run test:watch    # Tests en mode watch
npm run test:ui       # Interface UI pour les tests
npm run test:coverage # Tests avec couverture de code
npm run typecheck     # Vérifie les types sans compiler
npm run lint          # Vérifie le code (ESLint)
npm run lint:fix      # Corrige automatiquement les erreurs ESLint
npm run format        # Formate le code (Prettier)

# Bundle & Distribution
npm run pack:mcpb     # Crée le bundle .mcpb pour distribution
npm run clean         # Nettoie build/ node_modules/ *.mcpb
npm run clean:build   # Nettoie uniquement build/

使用MCP Inspector进行开发

LMCP检查员允许您以交互方式测试工具：

npm run inspector

在显示的URL处打开浏览器以测试每个工具。

测试手册

# Test rapide
npm run dev

# Le serveur affichera :
# ✅ Trello MCP Server v2.0.0 démarré avec succès
# 📋 33 outils disponibles: boards (2), lists (2), cards (11),
#    labels (5), dates (4), checklists (5), members (4)
# 🔐 Authentifié avec l'API Trello
# 🏗️ Architecture: Handler Registry Pattern

📚 文档

架构MCP

此服务器实现规范模型上下文协议2025-06-18我揭露了工具（工具）LLM可以调用这些工具与Trello交互。

错误管理

服务器自动管理：

✅ 身份验证无效（401）
✅ 未找到资源（404）
✅ 速率限制Trello（429）
✅ ID验证（24个字符）
✅ 网络连接

所有错误消息均为法语且明确。

API Trello

此服务器使用API REST Trello v1.要点：

基础URL : https://api.trello.com/1
认证：API密钥+令牌（OAuth 1.0）
速率限制 ：300个请求/10秒/令牌
超时每次请求30秒

🗺️ 路线图

📋 查看Trello的完整路线图

查看我们的Trello板，实时跟踪已完成、正在开发和计划的功能！

实际版本：1.4.0✅

v1.4的所有功能都可用：

✅ 完整的董事会管理（2个工具）
✅ 完整列表管理（2个工具）
✅ 完整的卡管理（11个工具）
- 基本CRUD（创建、阅读、评论）
- 移动和搜索地图
- 修改（名称、描述）
- 存档和删除
- 成员、清单、附件的完整详细信息
✅ 标签格式（5页）
- 创建、修改和删除标签
- 在卡片上添加/删除标签
- 支持优先级P1/P2/P3/P4
✅ 日期格式（4页）
- 设置和删除截止日期
- 标记为已完成
- 三段式约会

📋 即将发布的版本（v2.0）

👥 备忘录（转让）
☑️ 检查表格式
📎 附件（文件和链接）
⚡ 批量操作（Bulk）

查看董事会路线图查看每个功能的详细信息和优先级。

🤝 贡献

欢迎捐款！以下是如何做出贡献：

报告错误

打开一个问题具有：

问题描述
复制步骤
Node.js和服务器版本
日志相关内容

提供功能