Pytaiga MCP

🚀 MCP 代理サーバー（Taiga プラットフォームとの統合）

このプロジェクトは、Taiga プラットフォームと統合するための MCP 代理サーバーです。MCP プロトコルを通じた相互操作をサポートしています。

🚀 クイックスタート

この MCP 代理サーバーは、Taiga プラットフォームとの統合を容易にし、MCP プロトコルを通じた操作を可能にします。以下のセクションでは、インストール方法と使用方法を説明します。

✨ 主な機能

• 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()

認証とセッション管理

1. ユーザー認証

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

2. プロジェクトの作成

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

3. エピック（Epic）の作成

epic = client.call_tool("create_epic", {
    "session_id": session_id,
    "project_id": project_id,
    "subject": "New Feature",
    "description": "Implement new user feature"
})

4. ユーザーストーリー（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
})

5. セッション状態の照会

status = client.call_tool("session_status", {"session_id": session_id})

6. ユーザーのログアウト

client.call_tool("logout", {"session_id": session_id})

高度な使用法

プロジェクトの作成とタスクの追加

1. クライアントの初期化

client = Client()

2. ユーザーのログイン

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

3. プロジェクトの作成

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

4. エピック（Epic）の作成

epic = client.call_tool("create_epic", {
    "session_id": session_id,
    "project_id": project.id,
    "subject": "New Feature",
    "description": "Implement new user feature"
})

5. ユーザーストーリー（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

エラー処理

一般的なエラー

1. 認証失敗

Error: Authentication failed, invalid credentials

2. 権限不足

Error: Permission denied, insufficient privileges

3. プロジェクトが存在しない

Error: Project not found with given ID

FAQ

質問：セッションタイムアウトはどう処理しますか？

答：session_status ツールを呼び出してセッション状態を確認し、期限切れの場合は再ログインします。

質問：既存のシステムに統合できますか？

答：このプロジェクトは RESTful API と MCP プロトコルをサポートしており、既存のシステムに容易に統合できます。

貢献ガイド

1. プロジェクトリポジトリを Fork します。
2. 機能ブランチを作成します。
3. コードをコミットし、Pull Request を作成します。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいています。詳細は LICENSE ファイルを参照してください。