Universal ticket management MCP server for AI agents. Connect Linear, GitHub, Jira, Asana to Claude & AI workflows with intelligent token optimization.
概览
Universal ticket management interface for AI agents with MCP (Model Context Protocol) support. - : Simplified to Epic, Task, and Comment types - : Support for JIRA, Linear, GitHub Issues, and AI-Trackdown - : Native support for AI agent interactions - : Smart caching and async operations - : Beautiful terminal interface with colors and tables - : Built-in state transitions with validation - : Full-text search with multiple filters - : Parent issue lookup and filtered sub-issue retrieval - : Dedicated assignment tool with URL support and audit trails - : Intelligent label organization, deduplication, and cleanup with fuzzy matching - : Upload, list, and manage ticket attachments (AITrackdown adapter) - : Customize ticket writing guidelines for your team - : Detect duplicate tickets, identify stale work, and find orphaned tickets - : Available on PyPI with simple pip install - : Automatic adapter dependency detection and installation - : 70% token reduction for AI agent ticket list...
README
以下为原文 README 节选，完整内容请查看原文。
MCP Ticketer
Universal ticket management interface for AI agents with MCP (Model Context Protocol) support.
🚀 Features
- 🎯 Universal Ticket Model: Simplified to Epic, Task, and Comment types
- 🔌 Multiple Adapters: Support for JIRA, Linear, GitHub Issues, and AI-Trackdown
- 🤖 MCP Integration: Native support for AI agent interactions
- ⚡ High Performance: Smart caching and async operations
- 🎨 Rich CLI: Beautiful terminal interface with colors and tables
- 📊 State Machine: Built-in state transitions with validation
- 🔍 Advanced Search: Full-text search with multiple filters
- 🔗 Hierarchy Navigation: Parent issue lookup and filtered sub-issue retrieval
- 👤 Smart Assignment: Dedicated assignment tool with URL support and audit trails
- 🏷️ Label Management: Intelligent label organization, deduplication, and cleanup with fuzzy matching
- 📎 File Attachments: Upload, list, and manage ticket attachments (AITrackdown adapter)
- 📝 Custom Instructions: Customize ticket writing guidelines for your team
- 🔬 PM Monitoring Tools: Detect duplicate tickets, identify stale work, and find orphaned tickets
- 📦 Easy Installation: Available on PyPI with simple pip install
- 🚀 Auto-Dependency Install: Automatic adapter dependency detection and installation
- 💾 Compact Mode: 70% token reduction for AI agent ticket list queries (v0.15.0+)
⚡ Token Efficiency
MCP Ticketer is optimized for AI agent usage with built-in token management:
- 20k Token Limit: All tool responses stay under 20,000 tokens
- Automatic Pagination: Tools that could exceed limits support pagination
- Compact Mode: Minimal responses (15 tokens vs 185 per ticket)
- Progressive Disclosure: Summary first, details on demand
See 📄 Token Pagination section below for quick start, or docs/user-docs/features/TOKEN_PAGINATION.md for detailed technical guide.
📦 Installation
From PyPI (Recommended)
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"mcp-ticketer": {
"command": "/path/to/venv/bin/python",
"args": ["-m", "mcp_ticketer.mcp.server"],
"env": {
"MCP_TICKETER_ADAPTER": "linear",
"LINEAR_API_KEY": "your_key_here"
}
}
}
}