星战科技xingzhan.cloud
返回市场
高级看板MCP服务器

高级看板MCP服务器

作者：adriangrahldev3 星标更新：2025-10-11
安装使用来源：spider==github.com

项目介绍

🚀 高级 Trello MCP 服务器

增强型模型上下文协议服务器，用于 Trello 与 Cursor AI 的集成
提供完整的 API 覆盖，包含 40 多种工具和企业级功能

TypeScript Trello API MCP Protocol License

<a href="https://glama.ai/mcp/servers/@adriangrahldev/advanced-trello-mcp-server"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=1620430458,3094759507&fm=3081&app=3081&f=PNG?w=760&h=400" alt="高级 Trello 服务器 MCP 服务器" /> </a>

📋 概述

这是一个增强版的 Trello MCP 服务器，提供了 Trello 和 Cursor AI 之间的全面集成。最初支持 15 种基本工具，这个版本已经扩展到44 多种工具，覆盖了多个 Trello API 类别，并具备企业级功能。

✨ 特性

🎯 完整的 API 覆盖

  • 操作 API: 16 种工具（完整的审计跟踪、反应、评论）
  • 列表 API: 9 种工具（完整的列表管理）
  • 卡片 API: 8 种工具（增强的卡片操作）
  • 标签 API: 8 种工具（完整的标签管理）✅
  • 看板 API: 1 种工具（基本的看板访问）

🔧 企业特性

  • 使用严格的类型定义的TypeScript 实现
  • 所有输入和输出的Zod 验证
  • 批量操作的批量操作
  • 带详细错误信息的错误处理
  • 准备好的速率限制架构
  • 为未来 API 添加设计的可扩展设计

🚀 快速开始

先决条件

  • Node.js 18+
  • Trello API 密钥和令牌
  • 支持 MCP 的 Cursor AI

安装

  1. 克隆仓库

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

  2. 安装依赖

    npm install

  3. 构建项目

    npm run build

  4. 配置环境变量

    export TRELLO_API_KEY="your_api_key"
export TRELLO_API_TOKEN="your_api_token"

  5. 配置 Cursor MCP 在你的 ~/.cursor/mcp.json 中添加：

    {
  "servers": {
    "trello": {
      "command": "/path/to/advanced-trello-mcp-server/build/index.js",
      "env": {
        "TRELLO_API_KEY": "your_api_key",
        "TRELLO_API_TOKEN": "your_api_token"
      }
    }
  }
}

🛠️ 可用工具

📋 列表管理 (9 种工具)

  • get-lists - 获取看板中的所有列表
  • create-list - 创建新列表
  • update-list - 更新列表属性
  • archive-list - 归档/取消归档列表
  • move-list-to-board - 在看板之间移动列表
  • get-list-actions - 获取列表的操作历史
  • get-list-board - 从列表获取看板信息
  • get-list-cards - 获取列表中的卡片并进行过滤
  • archive-all-cards-in-list - 归档列表中的所有卡片
  • move-all-cards-in-list - 在列表之间移动所有卡片

🎯 卡片管理 (8 种工具)

  • create-card - 创建单个卡片
  • create-cards - 创建多个卡片（批量）
  • move-card - 在列表之间移动卡片
  • move-cards - 移动多个卡片（批量）
  • archive-card - 归档单个卡片
  • archive-cards - 归档多个卡片（批量）
  • get-tickets-by-list - 从特定列表获取卡片
  • add-comment - 向卡片添加评论

🏷️ 标签管理 (8 种工具) ✅ 完成

  • create-label - 创建单个标签
  • create-labels - 创建多个标签（批量）
  • add-label - 将标签添加到卡片
  • add-labels - 将标签添加到多个卡片（批量）
  • get-label - 获取详细的标签信息
  • update-label - 更新标签名称和颜色
  • delete-label - 根据 ID 删除标签
  • update-label-field - 更新特定的标签字段

📊 操作与审计 (16 种工具)

  • get-action - 获取详细的操作信息
  • update-action - 更新操作（评论）
  • delete-action - 删除操作（仅限评论）
  • get-action-field - 获取特定的操作字段
  • get-action-board - 从操作获取看板
  • get-action-card - 从操作获取卡片
  • get-action-list - 从操作获取列表
  • get-action-member - 从操作获取成员
  • get-action-member-creator - 获取操作创建者
  • get-action-organization - 从操作获取组织
  • update-comment-action - 更新评论文本
  • get-action-reactions - 获取操作反应
  • create-action-reaction - 向操作添加反应
  • get-action-reaction - 获取特定的反应
  • delete-action-reaction - 移除反应
  • get-action-reactions-summary - 获取反应摘要

🏢 看板管理 (1 种工具)

  • get-boards - 获取所有可访问的看板

📈 发展路线图

该项目遵循一个六阶段的战略扩展计划，以实现100% Trello API 覆盖率：

第一阶段：基础（正在进行中 - 已完成 1/3）

  • ✅ 完成列表 API (9 种工具)
  • ✅ 完成操作 API (16 种工具)
  • ✅ 完成标签 API (8 种工具) 已完成！
  • 🔄 增强卡片 API (还需要 15 种工具)
  • 🔄 增强看板 API (还需要 8 种工具)

第二阶段：生产力（计划中）

  • 检查列表 API (12 种工具)
  • 搜索 API (3 种工具)
  • 表情符号 API (2 种工具)

第三阶段：协作（计划中）

  • 成员 API (20 种工具)
  • 组织 API (15 种工具)

第四阶段：自动化（计划中）

  • 批量 API (3 种工具)
  • 自定义字段 API (12 种工具)
  • 网络钩子 API (8 种工具)

第五阶段：高级管理（计划中）

  • 通知 API (10 种工具)
  • 插件 API (8 种工具)
  • 令牌 API (6 种工具)

第六阶段：企业（计划中）

  • 企业 API (12 种工具)
  • 应用程序 API (4 种工具)

目标：总共 182 种工具（目前有 44 种）

🔧 开发

项目结构

advanced-trello-mcp-server/
├── src/                 # TypeScript 源代码
│   ├── index.ts         # 主 MCP 服务器实现
│   ├── tools/           # 模块化工具实现
│   ├── types/           # TypeScript 类型定义
│   └── utils/           # 共享实用工具
├── build/               # 编译后的 JavaScript 输出
│   └── index.js         # 可执行入口点
├── scripts/             # 构建和实用脚本
│   └── build.js         # 跨平台构建脚本
├── package.json         # 依赖项和脚本
├── tsconfig.json        # TypeScript 配置
└── README.md           # 此文件

构建

# 完整构建（TypeScript 编译 + shebang 注入）
npm run build

# 仅 TypeScript 编译
npm run compile

跨平台构建：构建脚本完全兼容 Windows、macOS 和 Linux，自动处理：

  • TypeScript 编译
  • shebang 注入 (#!/usr/bin/env node)
  • 执行权限（在 Unix 系统上）

开发工作流程

  1. 在 src/ 目录中进行更改
  2. 运行 npm run build 进行编译
  3. 使用 Cursor AI 测试
  4. 使用常规提交约定提交更改

🤝 贡献

欢迎贡献！请：

  1. 分叉仓库
  2. 创建功能分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'feat: 添加神奇功能')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 打开拉取请求

提交约定

我们使用 常规提交：

  • feat: - 新功能
  • fix: - 错误修复
  • docs: - 文档更改
  • refactor: - 代码重构
  • test: - 添加测试
  • chore: - 维护任务

📚 API 文档

此服务器基于官方 Trello REST API 文档 实现工具。每个工具包括：

  • Zod 模式验证以确保类型安全
  • 全面的错误处理
  • 可选参数支持
  • 适用时的批量操作
  • 详细的 JSDoc 注释

🐛 故障排除

常见问题

1. "Trello API 凭证未配置"

  • 确保设置了 TRELLO_API_KEY 和 TRELLO_API_TOKEN
  • 验证令牌具有适当的范围（至少需要 read，修改时需要 write）

2. "未找到工具" 错误

  • 重启 Cursor AI 以刷新 MCP 服务器
  • 验证构建是否成功 (npm run build)
  • 检查 MCP 配置在 ~/.cursor/mcp.json

3. 权限错误

  • 验证你的 Trello 令牌是否有权访问你尝试修改的看板/卡片
  • 一些操作需要 write 范围，而不仅仅是 read

📄 许可

本项目采用 MIT 许可证 - 详情参见 LICENSE 文件。

🙏 致谢

📊 统计数据

  • 总工具数: 44 (比原始增加了 15)
  • API 覆盖率: ~40% (目标: 100%)
  • 代码行数: 2,500+ TypeScript
  • 类型安全性: 100% 使用 Zod 验证
  • 文档: 全面的内联文档

为 Cursor AI 社区打造，充满爱心