Jira Assistant with MCP Integration

Jira Assistant with MCP Integration

MCP (Model Control Panel) を使用したツール呼び出しにより、Jira チケットを管理するための Streamlit ベースのアシスタントです。

Features

• 🤖 異なる操作のためのクリーンなタブ付きインターフェース
• 🎯 シンプルな会話コマンドで Jira チケットの作成、検索、管理が可能
• 🔄 外部 LLM に依存しないリアルタイムチケット作成
• 🛠️ 柔軟なツール呼び出しのための MCP フレームワークを構築
• 📊 チケット作成と検索のためのダイレクトフォームベースインターフェース

Screenshots

Tabbed Interface

アプリケーションは以下の独立したセクションを持つクリーンなタブ付きインターフェースを備えています:

1. Chat - チケット管理のための会話インターフェース
2. Create Ticket - フォームベースのチケット作成
3. Search Tickets - JQL を使用した高度な検索

Prerequisites

• Python 3.8+
• Jira アカウント (API アクセス付き)
• Jira ツールを備えた MCP サーバーが実行中

Installation

1. リポジトリをクローンします
2. 必要なパッケージをインストールします:

   pip install -r requirements.txt
   

3. .env ファイルで環境変数を設定します:

   JIRA_URL=https://your-domain.atlassian.net
   [email protected]
   JIRA_API_TOKEN=your-jira-api-token
   

Running the Application

スタートスクリプトを使用してアプリケーションを起動します:

./start_jira_assistant.sh

スクリプトは以下の処理を実行します:

1. MCP パッケージがインストールされているかを確認
2. 必要な環境変数を検証
3. MCP サーバーがまだ実行されていない場合は起動
4. Streamlit アプリケーションを起動

Usage Examples

Creating Tickets

チケットは 2 つの方法で作成できます:

チャットインターフェースを使用する

以下のような自然言語コマンドを入力します:

• "Create a new task in KAN titled 'Implement user authentication' with description 'We need to add a JWT-based authentication system for user login.'"
• "I need a bug ticket in KAN for 'Fix pagination in user list' describing 'The pagination controls are not working correctly when there are more than 10 users.'"

フォームインターフェースを使用する

1. "Create Ticket" タブに移動します
2. 必須フィールド (Project Key、Summary、Description) を入力します
3. Issue Type を選択します
4. "Create Ticket" をクリックします

Searching Tickets

チケットは 2 つの方法で検索できます:

チャットインターフェースを使用する

以下のような自然言語クエリを入力します:

• "Find all open tickets in the KAN project"
• "Show me all high priority bugs"
• "Search for tickets mentioning 'authentication' in the KAN project"

検索インターフェースを使用する

1. "Search Tickets" タブに移動します
2. JQL クエリを入力します (インターフェースに例が表示されます)
3. 結果の最大数を設定します
4. "Search" をクリックします

Getting Ticket Details

特定のチケットについての詳細を要求します:

• "Show details for ticket KAN-123"
• "What's the status of KAN-456?"

Direct Jira Tool

コマンドラインでの操作では、direct_jira_tool.py スクリプトを使用します:

# List available tools
./direct_jira_tool.py list

# Create a ticket
./direct_jira_tool.py create --project KAN --title "Fix login page" --description "The login page has a UI bug in Safari"

# Search for tickets
./direct_jira_tool.py search --query "project = KAN AND status = 'In Progress'"

# Get ticket details
./direct_jira_tool.py get --id KAN-123

Test MCP Client

test_mcp_client.py スクリプトを使用して MCP サーバーへの接続をテストできます:

# Run all tests
python test_mcp_client.py all

# Test connection only
python test_mcp_client.py connect

# Test creating a specific ticket
python test_mcp_client.py test_create --project KAN --title "Test ticket" --description "This is a test"

Troubleshooting

MCP Server Issues

MCP サーバーが正常に接続されない場合:

1. MCP サーバーのパスが正しいことを確認します
2. .env ファイルの Jira 認証情報を確認します
3. サイドバーの "Restart MCP Server" ボタンを使用します
4. test_mcp_client.py connect を使用して接続をテストします

Ticket Creation Issues

チケット作成で問題が発生した場合:

1. すべての必須フィールドが入力されていることを確認します
2. プロジェクトキーが存在し、正しくフォーマットされていることを確認します
3. Jira API トークンが十分な権限を持っていることを確認します
4. レスポンスで具体的なエラーメッセージを探します

Search Issues

Error executing tool search_jira_tickets: validation error のようなエラーメッセージで検索に問題が発生した場合:

1. JQL クエリが適切にフォーマットされていることを確認します
2. 特殊文字を含む複雑な JQL クエリの使用を避けます
3. まず project = KAN のようなシンプルなクエリで機能をテストします
4. MCP サーバーは現在、検索あたり 10 件の結果に制限されています

その他の問題

• ブラウザのコンソールとターミナル出力で詳細なエラーメッセージを確認してください
• すべての環境変数が正しく設定されていることを確認してください
• 正しいバージョンの mcp パッケージがインストールされていることを確認してください（pip install -U mcp）

最新アップデートの新機能

• 📋 タブ付きインターフェース: チャット、チケット作成、検索用の独立したタブ
• 🖋️ 改善されたチケット作成: LLM に頼らない直接フォームベースの作成
• 🔎 高度な検索: JQL ベースの検索、例、柔軟なフォーマット
• 🛡️ 強化されたエラーハンドリング: より良いエラーメッセージと検証
• 🧩 簡略化された依存関係: Gemini などの外部 API への依存を削除

開発

このプロジェクトに貢献するには：

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更を加えます
4. プルリクエストを送信します

ライセンス

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

謝辞

• Web アプリフレームワークの Streamlit
• ツール呼び出しインフラストラクチャの MCP