hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Allows AI assistants to manage Jira issues programmatically, including creating, listing, updating, getting details, deleting issues, and adding comments.

Jira MCP サーバー

Jira の REST API との統合を提供し、AI アシスタントが Jira の問題をプログラムで管理できるようにするモデルコンテキストプロトコルサーバー。

特徴

このサーバーは、Jira の問題を管理するためのツールを提供します。

新しい課題を作成する（タスク、エピック、サブタスク）
オプションのステータスフィルタリングを使用して問題を一覧表示する
既存の問題を更新する（概要、説明、ステータス）
詳細な問題情報を取得する
問題を削除する
問題にコメントを追加する

設定

前提条件

APIアクセス権限を持つJiraアカウント
Jira API トークン ( Atlassian アカウント設定から生成できます)

インストール

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

構成

作業ディレクトリに.jira-config.jsonファイルを作成します。

{
  "projectKey": "YOUR_PROJECT_KEY"
}

Jira の資格情報を使用して MCP サーバーを構成します。

MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-server/build/index.js"],
      "env": {
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

利用可能なツール

問題作成

新しいJiraの問題を作成する

必須パラメータ:
- working_dir: .jira-config.json を含むディレクトリ
- 概要: 問題のタイトル
- 説明: 問題の説明
- タイプ: 課題タイプ (タスク、エピック、またはサブタスク)

リストの問題

プロジェクト内の問題を一覧表示する

必須パラメータ:
- working_dir: .jira-config.json を含むディレクトリ
オプションパラメータ:
- ステータス: ステータスでフィルタリングします (例: 「To Do」、「進行中」、「完了」)

更新問題

既存の問題を更新します

必須パラメータ:
- working_dir: .jira-config.json を含むディレクトリ
- issue_key: 発行キー（例：PRJ-123）
オプションパラメータ:
- 概要: 新しいタイトル
- 説明: 新しい説明
- ステータス: 新しいステータス

発行を取得

特定の問題に関する詳細情報を取得します

必須パラメータ:
- working_dir: .jira-config.json を含むディレクトリ
- issue_key: 発行キー（例：PRJ-123）

問題を削除

Jira の問題を削除します

必須パラメータ:
- working_dir: .jira-config.json を含むディレクトリ
- issue_key: 発行キー（例：PRJ-123）

コメントを追加

既存の問題にコメントを追加します

必須パラメータ:
- working_dir: .jira-config.json を含むディレクトリ
- issue_key: 発行キー（例：PRJ-123）
- コメント: 追加するコメントテキスト

発達

自動リビルドを使用した開発の場合:

npm run watch

エラー処理

サーバーには、次の包括的なエラー処理が含まれています。

無効なプロジェクトキー
構成がありません
無効な問題タイプ
API認証エラー
無効なステータス遷移

出力フォーマット

問題情報は、次の内容を含むようにフォーマットされます。

問題キーと概要
問題の種類とステータス
作成日と作成者
説明
著者とタイムスタンプ付きのコメント（ある場合）

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Jira の REST API との統合を提供し、AI アシスタントが Jira の問題をプログラムで管理できるようにします。

mcp-jira-server