Andypost MCP Server Ts Trello

🚀 Trello MCP 服务器（TypeScript）

Trello MCP 服务器使用 TypeScript 实现，集成了 Trello 功能，为 AI 助手提供了与 Trello 看板、列表和卡片进行交互的工具，极大地提升了操作的便捷性。

🚀 快速开始

要使用此 Trello MCP 服务器，你需要先满足一些先决条件，然后进行安装和配置。

1. 先决条件：确保你已经安装了 Node.js 18.x 或更高版本、npm 或 yarn，并且拥有 Trello API 凭证。
2. 安装：在项目目录下，执行以下命令安装依赖项：

# 安装依赖项
make install

3. 配置：在根目录中创建一个 .env 文件，并添加你的 Trello 凭证：

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

4. 启动服务器：安装和配置完成后，使用以下命令启动服务器：

make start

✨ 主要特性

• 完全集成：这是一个完全集成 Trello API 的 MCP 工具，能让你充分利用 Trello 的各项功能。
• 异步操作：采用异步操作，有效提升服务器性能，确保操作的流畅性。
• 类型安全：使用 TypeScript 实现，保证了代码的类型安全，减少潜在的错误。
• 全面错误处理：具备全面的错误处理机制，可应对 API 认证错误、速率限制、网络问题和无效请求参数等情况。
• 基于环境的配置：支持基于环境的配置，方便根据不同的使用场景进行灵活调整。

📦 安装指南

安装依赖项

make install

💻 使用示例

MCP 工具

get_boards

获取当前用户的所有 Trello 看板。

// 无需输入参数

get_lists

从指定的看板获取所有列表。

{
  "request": {
    "board_id": string // 看板 ID
  }
}

get_cards

从指定看板或特定列表中获取卡片。

{
  "request": {
    "board_id": string,    // 看板 ID
    "list_id"?: string     // 可选：特定列表的 ID
  }
}

get_card_details

获取特定卡片的详细信息。

{
  "request": {
    "card_id": string      // 卡片 ID
  }
}

📚 详细文档

可用命令

# 安装依赖项
make install

# 构建项目
make build

# 启动服务器
make start

# 清理构建文件
make clean

# 运行代码检查工具
make lint

开发

该项目使用 TypeScript 实现类型安全，提供了更好的开发者体验。源代码组织如下：

• src/index.ts - 服务器主入口点
• src/trello-client.ts - Trello API 客户端实现
• src/types.ts - TypeScript 类型定义

构建

该项目使用 TypeScript 编译器进行构建：

# 构建项目
make build

# 输出文件位于 build/ 目录中

与 Cline 一起使用

要与 Cline 一起使用此 MCP 服务器，请将以下配置添加到您的 Cline MCP 设置文件（~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：

{
  "mcp_servers": {
    "trello_server": {
      "url": "http://localhost:3000",
      "type": "trello"
    }
  },
  "default_mcp_server": "trello_server"
}

🔧 技术细节

该项目使用 TypeScript 实现类型安全，通过异步操作提升性能。在错误处理方面，实现了全面的错误处理机制，能够应对 API 认证错误、速率限制、网络问题和无效请求参数等情况。项目结构清晰，源代码按照功能模块进行组织，方便开发和维护。

📄 许可证

此项目使用 ISC 许可证。请查看 LICENSE 文件以获取详细信息。