カーソル用 JIRA MCP サーバー

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

✨ 特徴

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

🚀 クイックスタート

インストール

# 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`	テストを実行する

📘 リソース

📄 ライセンス

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

JIRA を Cursor IDE に直接統合するモデルコンテキストプロトコルサーバー。これにより、ユーザーはエディターを離れることなく、割り当てられた問題を表示したり、特定のチケットの詳細情報を取得したり、JIRA の問題をローカルタスクに変換したりできるようになります。

Related MCP Servers

MCP Atlassian
sooperset
A
security
A
license
A
quality
Model Context Protocol (MCP) server for Atlassian Cloud products (Confluence and Jira). This integration is designed specifically for Atlassian Cloud instances and does not support Atlassian Server or Data Center deployments.
Last updated -
27
2,005
Python
MIT License
MCP Server for Cursor
AntDX316
-
security
F
license
-
quality
A Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
Last updated -
690
1
Python
HH JIRA MCP Server
alexeydubinin
A
security
F
license
A
quality
A Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.
Last updated -
3
2
Python
JIRA MCP Server
klauseduard
-
security
F
license
-
quality
A Model Context Protocol server that enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.
Last updated -
Python

View all related MCP servers

JIRA MCP Server