Jira Y9t

🚀 JIRA MCP サーバー

このサーバーは、大型言語モデル（LLMs）が標準化されたツールとコンテキストを通じてJIRAとやり取りできるようにするMCPサーバーです。JQLを使用した問題の検索や、特定の問題の詳細情報の取得などの機能を提供します。

✨ 主な機能

• JQL 検索：複雑なJQLクエリを実行し、ページングをサポートします。
• 問題詳細情報：特定のJIRA問題の詳細情報を取得します。

📦 インストール

前提条件

• npm がインストールされていること
• APIアクセス権を持つJIRAインスタンス
• JIRA APIトークンまたは個人用アクセストークン
• APIトークンに関連付けられたJIRAユーザーのメールアドレス

JIRA API 資格情報の取得

1. あなたのAtlassianアカウントにログインします https://id.atlassian.com
2. セキュリティ設定に移動します
3. APIトークンの下で、「APIトークンを作成」を選択します
4. トークンに意味のある名前（例：「MCP サーバー」）を付けます
5. 生成されたトークンをコピーします — このトークンは再度表示されません！
6. このトークンを JIRA_API_KEY として使用します
7. Atlassianアカウントに関連付けられたメールアドレスを JIRA_USER_EMAIL として使用します

💻 使用例

Claude Desktop との統合

1. Claude Desktopの設定ファイルにサーバー設定を追加します：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net",
        "JIRA_USER_EMAIL": "your-email@company.com",
        "JIRA_API_KEY": "your-api-token"
      }
    }
  }
}

2. Claude Desktopを再起動して新しい設定を読み込みます。

利用可能なツール

1. JQL 検索 (jql_search)

カスタムパラメータを使用してJQLクエリを実行します。

入力例：

{
  "command": "jql_search",
  "issueQuery": "project = ABC AND status = 'In Progress'",
  "maxResults": 50,
  "startIndex": 0
}

出力例：

{
  "issues": [
    {
      "id": "1234",
      "key": "ABC-123",
      "title": "Implement New Feature",
      "status": "In Progress",
      "priority": "High",
      "assignee": "张三"
    },
    // その他の問題...
  ],
  "total": 100
}

2. 問題詳細情報の取得 (get_issue)

特定の問題の詳細情報を取得します。

入力例：

{
  "command": "get_issue",
  "issueIdOrKey": "ABC-123"
}

出力例：

{
  "id": "1234",
  "key": "ABC-123",
  "title": "Implement New Feature",
  "status": "In Progress",
  "priority": "High",
  "assignee": "张三",
  "description": "需要实现新功能...",
  "labels": ["feature", "urgent"],
  "comments": [
    {
      "id": "5678",
      "author": "李四",
      "content": "请优先处理此问题。",
      "createdAt": "2023-10-01T12:00:00Z"
    },
    // その他のコメント...
  ],
  "history": [
    {
      "actionDate": "2023-10-01T10:00:00Z",
      "action": "status changed to 'In Progress'"
    },
    // その他の記録...
  ]
}

開発情報

npm を使用したインストール

npm install jira-mcp-server

手動インストール

1. 最新バージョンの圧縮ファイルをダウンロードします
2. ファイルを目的のディレクトリに解凍します
3. サーバーを起動します：

node index.js

設定

環境変数

.env ファイルを作成し、以下の内容を追加します：

JIRA_INSTANCE_URL=https://your-instance.atlassian.net
JIRA_USER_EMAIL=your-email@company.com
JIRA_API_KEY=your-api-token

📄 ライセンス

MIT

コントリビューションガイド

コントリビューションを歓迎します！PRをいつでも送信してください。