MCP Server Atlassian Jira

🚀 Atlassian Jira MCP サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーを提供します。このサーバーは、人工知能アシスタント（Anthropic の Claude、Cursor AI などの MCP 互換クライアント）と Atlassian Jira インスタンスの間の橋渡し役となります。人工知能がリアルタイムで安全にプロジェクト、問題、その他の Jira リソースにアクセスし、相互作用できるようにします。

🚀 クイックスタート

このサーバーを使用することで、人工知能アシスタントが Atlassian Jira インスタンスと安全にやり取りできるようになります。以下の手順に従って、サーバーをセットアップし、AI アシスタントと接続しましょう。

✨ 主な機能

• 最小入力、最大出力理念：単純な識別子（プロジェクト名や問題 ID など）を入力するだけで、豊富な情報を取得できます。
• Jira からの直接データ取得：JQL クエリと直接的な問題/プロジェクト検索をサポートします。
• 強力な統合能力：人工知能アシスタントとシームレスに連携し、リアルタイムの Jira コンテキストを提供します。

📦 インストール

前提条件

• Node.js と npm：Node.js 14 以上と npm 5+ が必要です。
• Jira API アクセス権：Jira インスタンスが API を通じたアクセスを許可していることを確認してください。
• 管理者権限：API アクセスと資格情報の設定には管理者権限が必要になる場合があります。

Atlassian API トークンの取得

Jira とやり取りするには、認証用の API トークンが必要です。以下の手順で取得してください。

1. Jira アカウントにログインします。
2. Jira 設定 > ユーザープロファイルに移動します。
3. API トークン セクションを見つけてクリックします。
4. 新しい API トークンを作成し、保存します。

資格情報の設定

方法 A: 設定ファイルの使用

~/.jira/config ファイルを作成または編集し、以下の内容を追加します。

{
    "environments": {
        "default": {
            "url": "https://your-domain.atlassian.net",
            "email": "your.email@example.com",
            "api-token": "your_api_token"
        }
    }
}

方法 B: コマンドラインでの設定

以下のコマンドを実行し、指示に従って情報を入力します。

mcp-atlassian-jira config

人工知能アシスタントの接続

サーバーを AI アシスタントと統合するには、以下の手順を実行します。

1. サーバーのインストールと起動

npm install -g @aashari/mcp-server-atlassian-jira
mcp-atlassian-jira start

2. API エンドポイントの設定：AI アシスタントで Jira データソースを設定し、MCP サーバーのアドレスを指定します。
3. 相互作用の開始

# 例: プロジェクト情報の取得
mcp-atlassian-jira get-project --project-key-or-id YOUR_PROJECT_KEY

💻 使用例

基本的な使用法

すべてのプロジェクトの一覧表示

mcp-atlassian-jira ls-projects

プロジェクトの詳細情報の取得

mcp-atlassian-jira get-project --project-key-or-id YOUR_PROJECT_KEY

JQL クエリによる問題の一覧表示

mcp-atlassian-jira ls-issues --jql "project = DEV AND status = 'In Progress'"

問題の詳細情報の取得

mcp-atlassian-jira get-issue --issue-id-or-key PROJ-123

高度な使用法

コマンドラインインターフェイス（CLI）の使用

クイック使用（npx を使用）

npx -y @aashari/mcp-server-atlassian-jira ls-projects
npx -y @aashari/mcp-server-atlassian-jira get-issue --issue-id-or-key PROJ-123

グローバルインストール

npm install -g @aashari/mcp-server-atlassian-jira
mcp-atlassian-jira ls-projects

ヘルプの取得

--help を使用して、すべてのコマンドのオプションと使い方を確認できます。

mcp-atlassian-jira --help
mcp-atlassian-jira ls-projects --help

📚 ドキュメント

什么是 MCP？

モデルコンテキストプロトコル（MCP）は、人工知能システムが外部ツールやデータソースに安全かつコンテキストに関連して接続できるようにするオープン標準です。このサーバーは Jira Cloud 用に MCP を実装し、Jira データと人工知能アシスタントを橋渡しします。

📄 ライセンス

ISC License