Andypost MCP Server Ts Trello

🚀 Trello MCP Server (TypeScript)

A Model Context Protocol (MCP) server integrated with Trello, implemented in TypeScript, providing AI assistants with tools to interact with Trello boards, lists, and cards.

✨ Features

• An MCP tool fully integrated with the Trello API.
• Asynchronous operations for better performance.
• Type safety achieved through TypeScript.
• Comprehensive error handling.
• Environment-based configuration.

📋 Prerequisites

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

📦 Installation

# Install dependencies
make install

⚙️ Configuration

Create a .env file in the root directory and add 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 files
make clean

# Run the code linter
make lint

🛠️ MCP Tools

get_boards

Get all Trello boards of the current user.

// No input parameters required

get_lists

Get all lists from a specified board.

{
  "request": {
    "board_id": string // Board ID
  }
}

get_cards

Get cards from a specified board or a specific list.

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

get_card_details

Get detailed information about a specific card.

{
  "request": {
    "card_id": string      // Card ID
  }
}

👨‍💻 Development

This project uses TypeScript to achieve type safety and provide a better developer experience. The source code is organized as follows:

• src/index.ts - The main entry point of the server.
• src/trello-client.ts - The implementation of the Trello API client.
• src/types.ts - TypeScript type definitions.

🏗️ Build

This project is built using the TypeScript compiler:

# Build the project
make build

# The output files are located in the build/ directory.

🚫 Error Handling

The server implements comprehensive error handling, including:

• API authentication errors.
• Rate limits.
• Network issues.
• Invalid request parameters.

🤝 Contribution Guidelines

1. Fork the repository.
2. Create a 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):

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

📄 License

This project is licensed under the ISC license. See the LICENSE file for details.