I am creating this repo to maintain version of my taiga mcp project that I am creating to facilitate automations
概览
Taiga MCP Server enables seamless integration between Large Language Models (LLMs) and Taiga project management platform through the Model Context Protocol. Built with Python's async/await patterns and type-safe Pydantic models, it provides a robust, production-ready solution for AI-powered project management automation. - : Interact with Taiga using conversational commands - : Built on modern async/await for high performance - : Full Pydantic validation for reliability - : Comprehensive error handling and logging - : Clean architecture for easy feature additions - : Works out-of-the-box with Claude Desktop, Cursor, Windsurf - : Non-blocking I/O for optimal performance - : Token management with auto-refresh - : Auto-fetch all or page-by-page - : Version-based updates prevent conflicts - : Automatic detection and handling - : Use IDs, slugs, or #ref numbers interchangeably - : 3.10 or higher - : taiga.
README
以下为原文 README 节选，完整内容请查看原文。
Taiga MCP Server
📋 Overview
Taiga MCP Server enables seamless integration between Large Language Models (LLMs) and Taiga project management platform through the Model Context Protocol. Built with Python’s async/await patterns and type-safe Pydantic models, it provides a robust, production-ready solution for AI-powered project management automation.
Why Taiga MCP?
- 🤖 Natural Language Interface: Interact with Taiga using conversational commands
- 🔄 Async-First: Built on modern async/await for high performance
- 🛡️ Type-Safe: Full Pydantic validation for reliability
- 🎯 Production Ready: Comprehensive error handling and logging
- 🔌 Extensible: Clean architecture for easy feature additions
- 📦 Zero Config: Works out-of-the-box with Claude Desktop, Cursor, Windsurf
✨ Features
Core Capabilities
| Feature | Description |
|---|---|
| 🔐 Authentication | Token-based auth with automatic refresh |
| 📊 Project Management | List, view, and search projects by ID or slug |
| 📝 User Stories | Full CRUD operations with pagination support |
| ✅ Task Management | Create and organize tasks within stories |
| 👥 Team Collaboration | View members and assign work |
| 🏷️ Rich Metadata | Tags, story points, due dates, custom fields |
| 🔍 Flexible Queries | Support for IDs, slugs, and reference numbers (#42) |
Technical Features
- Async Architecture: Non-blocking I/O for optimal performance
- Smart Caching: Token management with auto-refresh
- Intelligent Pagination: Auto-fetch all or page-by-page
- Optimistic Locking: Version-based updates prevent conflicts
- Role-Based Points: Automatic detection and handling
- Flexible Identifiers: Use IDs, slugs, or #ref numbers interchangeably
🚀 Quick Start
Prerequisites
- Python: 3.10 or higher
- Taiga Account: taiga.io or self-hosted instance
- MCP Client: Claude Desktop, Cursor, Windsurf, or any MCP-compatible client
Installation
# Clone the repository
git clone https://github.com/yourusername/taiga-mcp.git
cd taiga-mcp
# Create virtual environment (or use conda)
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# Install with dev dependencies
pip install -e ".[dev]"
# Configure credentials
cp .env.example .env安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →