Integrations

Provides system time integration with customizable date and time formatting and locale support.
Allows access to Jira issues directly from the IDE, including viewing assigned issues, getting detailed information on specific issues, and converting Jira issues into local tasks.

🔗 カーソル用 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

F

license - not found

-

quality - not tested

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

JIRA MCP Server for Cursor