Trello MCP Server (TypeScript)

此包由 MCPFlow 打包并发布到npm仓库。

用 TypeScript 实现的 Trello 集成的模型上下文协议（MCP）服务器

安装与使用

直接使用npx运行:

npx @mcpflow.io/mcp-trello-mcp-server-typescript

或者先安装后使用:

# 安装
npm install @mcpflow.io/mcp-trello-mcp-server-typescript

# 使用
npx @mcpflow.io/mcp-trello-mcp-server-typescript

使用方法

Installation

## 工具函数

### get_boards

Retrieves all Trello boards for the authenticated user.

**参数:**


### get_lists

Fetches all lists from a specified board.

**参数:**

- `board_id`: ID of the board

### get_cards

Gets cards from a board or specific list.

**参数:**

- `list_id`: Optional ID of a specific list
- `board_id`: ID of the board

### get_card_details

Retrieves detailed information about a specific card.

**参数:**

- `card_id`: ID of the card

### update_card

Updates properties of a specific card.

**参数:**

- `card_id`: ID of the card
- `update_data`: Properties to update on the card



## 原始信息

- **开发者:** andypost
- **版本:** 1.0.0
- **许可证:** 未指定
- **原始仓库:** [andypost/mcp-server-ts-trello](https://github.com/andypost/mcp-server-ts-trello)

## 原始README

# Trello MCP Server (TypeScript)

A TypeScript implementation of a Model Context Protocol (MCP) server for Trello integration, providing tools for AI assistants to interact with Trello boards, lists, and cards.

## Features

- Full Trello API integration through MCP tools
- Asynchronous operations for better performance
- Type-safe implementation using TypeScript
- Comprehensive error handling
- Environment-based configuration

## Prerequisites

- Node.js 18.x or higher
- npm or yarn
- Trello API credentials

## Installation

```bash
# Install dependencies
make install

Configuration

Create a .env file in the root directory with your Trello credentials:

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

Available Commands

# Install dependencies
make install

# Build the project
make build

# Start the server
make start

# Clean build artifacts
make clean

# Run linter
make lint

MCP Tools

get_boards

Retrieves all Trello boards for the authenticated user.

// No input parameters required

get_lists

Fetches all lists from a specified board.

{
  "request": {
    "board_id": string // ID of the board
  }
}

get_cards

Gets cards from a board or specific list.

{
  "request": {
    "board_id": string,    // ID of the board
    "list_id"?: string     // Optional: ID of a specific list
  }
}

get_card_details

Retrieves detailed information about a specific card.

{
  "request": {
    "card_id": string      // ID of the card
  }
}

Development

The project uses TypeScript for type safety and better developer experience. The source code is organized as follows:

• src/index.ts - Main server entry point
• src/trello-client.ts - Trello API client implementation
• src/types.ts - TypeScript type definitions

Building

The project uses TypeScript compiler for building:

# Build the project
make build

# The output will be in the build/ directory

Error Handling

The server implements comprehensive error handling for:

• API authentication errors
• Rate limiting
• Network issues
• Invalid request parameters

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Using with Cline

To use this MCP server with Cline, add the following configuration to your Cline MCP settings file (~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "trello-ts": {
      "command": "node",
      "args": ["/path/to/mcp-server-ts-trello/build/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key",
        "TRELLO_TOKEN": "your_token"
      }
    }
  }
}

After adding the configuration and restarting Cline, you can use the following MCP tools:

• get_boards: List all Trello boards
• get_lists: Get lists from a board
• get_cards: Get cards from a board or list
• get_card_details: Get detailed card information

License

ISC License - See LICENSE file for details