MCP Server for Jira

Jira API と連携するためのMCPサーバー

機能

• Jira課題の検索
• 課題の詳細情報取得
• 課題の作成
• 課題の更新
• コメントの追加
• 課題ステータスの移行（ワークフロー）

インストール

# 依存関係のインストール
npm install

# 環境変数設定
cp .env.example .env
# .envファイルを編集して適切なJira API資格情報を設定

環境変数の設定

.envファイルに以下の環境変数を設定してください：

• PORT: サーバーのポート番号（デフォルト: 3000）
• JIRA_API_URL: JiraのAPIのURL（例: https://your-domain.atlassian.net/rest/api/3）
• JIRA_API_EMAIL: JiraのAPIアクセス用のメールアドレス
• JIRA_API_TOKEN: JiraのAPIトークン
• LOG_LEVEL: ログレベル（debug, info, warn, error）

起動方法

# 開発モード
npm run dev

# 本番モード
npm start

API エンドポイント

課題検索

GET /api/jira/issues?jql=project=PROJ

クエリパラメーター:

• jql: 検索用のJQLクエリ（必須）
• maxResults: 最大結果数（オプション、デフォルト: 50）

課題詳細取得

GET /api/jira/issues/:issueKey

パスパラメーター:

• issueKey: 課題キー（例: PROJ-123）

課題作成

POST /api/jira/issues

リクエストボディ例:

{
  "fields": {
    "project": {
      "key": "PROJ"
    },
    "summary": "課題のタイトル",
    "issuetype": {
      "id": "10001"
    },
    "priority": {
      "id": "3"
    }
  }
}

課題更新

PUT /api/jira/issues/:issueKey

パスパラメーター:

• issueKey: 課題キー

リクエストボディ例:

{
  "fields": {
    "summary": "更新されたタイトル",
    "description": {
      "type": "doc",
      "version": 1,
      "content": [
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "更新された説明"
            }
          ]
        }
      ]
    }
  }
}

コメント追加

POST /api/jira/issues/:issueKey/comments

パスパラメーター:

• issueKey: 課題キー

リクエストボディ例:

{
  "comment": "これは新しいコメントです"
}

課題の移行（ステータス変更）

POST /api/jira/issues/:issueKey/transitions

パスパラメーター:

• issueKey: 課題キー

リクエストボディ例:

{
  "transitionId": "21"
}

ロギング

ログは以下の場所に保存されます：

• logs/combined.log: すべてのログ
• logs/error.log: エラーログのみ