🔗 カーソル用 JIRA MCP サーバー

Name: JIRA MCP Server
Author: Dsazz

✨ 特徴

📋カーソルから直接 JIRA にアクセスする
- IDE を離れずに割り当てられた課題を表示
- 1つのコマンドで特定の問題に関する詳細情報を取得
- JIRA の問題をシームレスにローカルタスクに変換
⏰システム時間の統合
- カスタマイズ可能な日付と時刻のフォーマット
- date-fns によるロケールサポート

Related MCP server: MCP Server for Cursor

🚀 クイックスタート

インストール

# Clone the repository git clone https://github.com/Dsazz/mcp-jira.git cd mcp-jira # Install dependencies npm install # Set up environment variables cp .env.example .env # Edit .env with your JIRA credentials

構成

次の変数を含む.envファイルを作成します。

JIRA_HOST=https://your-instance.atlassian.net JIRA_USERNAME=your-email@example.com JIRA_API_TOKEN=your-jira-api-token-here

🔑 JIRA APIトークンに関する重要なお知らせ
トークンには、 =記号などの特殊文字を含めることができます。
.envファイル内の1行にトークンを配置します
トークン値を引用符で囲まないでください
Atlassianから提供されたトークンを正確に貼り付けます

🛠️ 開発ツール

MCP検査官

MCP Inspector は、MCP サーバーをテストおよびデバッグするための強力なツールです。

# Run the inspector (no separate build step needed) npm run inspect

検査官は自動的に次の操作を実行します。

.envから環境変数を読み込みます
占有されているポート（5175、3002）をクリーンアップします
必要に応じてプロジェクトを構築する
設定に従ってMCPサーバーを起動します
インスペクターUIを起動します

http://localhost:5175?proxyPort=3002のインスペクターにアクセスします。

ポートの競合が発生した場合:

npm run cleanup-ports

インスペクタを使ったデバッグ

インスペクター UI を使用すると、次のことが可能になります。

利用可能なすべての MCP 機能を表示
ツールを実行して応答を検証する
JSON通信を分析する
異なるパラメータでテストする

詳細については、 MCP Inspector GitHub リポジトリを参照してください。

Claude Desktopとの統合

Claude を使って直接 MCP サーバーをテストします。

サーバーを構築して実行します。
npm run build # You must build the project before running it node dist/index.js
Claude デスクトップを設定します。
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
MCP 構成を追加します。
{ "mcpServers": { "JIRA Tools": { "command": "node", "args": ["/absolute/path/to/your/project/dist/index.js"], "env": { "JIRA_USERNAME": "your-jira-username", "JIRA_API_TOKEN": "your-jira-api-token", "JIRA_HOST": "your-jira-host.atlassian.net" } } } }
Claude Desktop を再起動して、次のコマンドでテストします。
What time is it right now?
または
Show me my assigned JIRA issues.

🔌 カーソル IDE との統合

⚠️ 重要: Cursor IDE または Claude Desktop と統合する前に、 npm run buildを使用してプロジェクトをビルドする必要があります。

この MCP サーバーを Cursor IDE の MCP 構成に追加します。

{ "mcpServers": { "JIRA Tools": { "command": "node", "args": ["/absolute/path/to/your/project/dist/index.js"], "env": { "JIRA_USERNAME": "your-jira-username", "JIRA_API_TOKEN": "your-jira-api-token", "JIRA_HOST": "your-jira-host.atlassian.net" } } } }

🧰 利用可能なツール

JIRAツール

道具	説明	パラメータ	返品
`jira_get_assigned_issues`	自分に割り当てられたすべての問題を取得します	なし	Markdown形式の問題リスト
`jira_get_issue`	特定の問題に関する詳細情報を取得します	`issueKey` : 発行キー（例：PD-312）	Markdown形式の問題の詳細
`jira_create_task`	JIRA の問題からローカルタスクを作成します	`issueKey` : 発行キー（例：PD-312）	Markdown形式のタスク

システム時間ツール

道具

説明

パラメータ

返品

get_system_time

現在のシステム時刻を取得します

format

: (オプション) date-fns フォーマット文字列

フォーマットされた日付/時刻文字列

📁 プロジェクト構造

src/ ├── features/ # MCP features (JIRA, system time) ├── server/ # MCP server implementation ├── shared/ # Shared utilities └── index.ts # Main entry point

NPMスクリプト

指示	説明
`npm run build`	プロジェクトを構築する
`npm run publish`	パッケージをビルドしてnpmレジストリに公開する
`npm run inspect`	デバッグのためにMCPインスペクタで実行する
`npm run cleanup-ports`	検査官が使用するポートを解放する
`npm test`	テストを実行する