Pytaiga MCP

🚀 MCP 代理服務器

這是一個用於與 Taiga 平臺集成的 MCP 代理服務器，支持通過 MCP 協議進行交互操作，能幫助用戶更便捷地管理 Taiga 項目。

🚀 快速開始

本 MCP 代理服務器可助力你與 Taiga 平臺進行交互。下面為你介紹如何快速安裝並使用該項目。

✨ 主要特性

• MCP 兼容性：完全遵循 MCP 協議規範
• 認證授權：支持用戶身份驗證和權限管理
• 項目管理：實現對 Taiga 項目的 CRUD 操作
• 任務跟蹤：支持史詩（Epic）、用戶故事（User Story）等任務的創建和追蹤
• 性能優化：包含連接池、限流和重試機制

📦 安裝指南

快速安裝

使用以下命令快速安裝項目：

pip install taiga-mcp-proxy

從源碼安裝

1. 克隆倉庫：

git clone https://github.com/yourusername/pyTaigaMCP.git
cd pyTaigaMCP

2. 安裝依賴：

./install.sh

💻 使用示例

基礎用法

初始化 MCP 客戶端

from mcp.client import Client

client = Client()

認證與會話管理

# 用戶認證
auth_result = client.call_tool("login", {
    "username": "admin",
    "password": "password123"
})
session_id = auth_result["session_id"]

# 項目創建
project = client.call_tool("create_project", {
    "session_id": session_id,
    "name": "My Project",
    "description": "A new Taiga project"
})

# 創建史詩（Epic）
epic = client.call_tool("create_epic", {
    "session_id": session_id,
    "project_id": project_id,
    "subject": "New Feature",
    "description": "Implement new user feature"
})

# 創建用戶故事（User Story）
story = client.call_tool("create_user_story", {
    "session_id": session_id,
    "project_id": project_id,
    "subject": "Login Functionality",
    "description": "Add user login functionality",
    "epic_id": epic_id
})

# 會話狀態查詢
status = client.call_tool("session_status", {"session_id": session_id})

# 用戶註銷
client.call_tool("logout", {"session_id": session_id})

高級用法

示例：創建項目並添加任務

# 初始化客戶端
client = Client()

# 用戶登錄
auth_result = client.call_tool("login", {
    "username": "admin",
    "password": "secret"
})
session_id = auth_result["session_id"]

# 創建項目
project = client.call_tool("create_project", {
    "session_id": session_id,
    "name": "New Project",
    "description": "A new Taiga project"
})

# 創建史詩（Epic）
epic = client.call_tool("create_epic", {
    "session_id": session_id,
    "project_id": project.id,
    "subject": "New Feature",
    "description": "Implement new user feature"
})

# 創建用戶故事（User Story）
story = client.call_tool("create_user_story", {
    "session_id": session_id,
    "project_id": project.id,
    "subject": "Login Functionality",
    "description": "Add user login functionality",
    "epic_id": epic.id
})

📚 詳細文檔

項目結構

pyTaigaMCP/
├── src/
│   ├── server.py          # MCP 服務器實現，包含工具方法
│   ├── taiga_client.py    # Taiga API 客戶端，提供 CRUD 操作
│   ├── tools.py           # MCP 工具定義
│   └── config.py          # 配置設置，使用 Pydantic 管理
├── tests/
│   ├── conftest.py        # 共享 pytest 固定件
│   ├── unit/              # 單元測試
│   └── integration/       # 集成測試
├── pyproject.toml         # 項目配置和依賴項管理
├── install.sh             # 安裝腳本
├── run.sh                 # 服務器執行腳本
└── README.md              # 項目文檔

測試

運行測試使用 pytest：

# 運行所有測試
pytest

# 運行單元測試
cd tests && pytest unit/

# 執行測試覆蓋率檢查
coverage run -m pytest && coverage report

錯誤處理

常見錯誤

• 認證失敗：

Error: Authentication failed, invalid credentials

• 權限不足：

Error: Permission denied, insufficient privileges

• 項目不存在：

Error: Project not found with given ID

FAQ

問題：如何處理會話超時？

答：調用 session_status 工具可以檢查會話狀態，若已過期則重新登錄。

問題：能否集成到現有系統中？

答：該項目提供 RESTful API 和 MCP 協議支持，可方便地與現有系統集成。

貢獻指南

1. Fork 項目倉庫。
2. 創建功能分支。
3. 提交代碼並創建 Pull Request。

📄 許可證

本項目遵循 MIT 許可證，詳見 LICENSE 文件。