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

✨ 特徴

• 📋カーソルから直接 JIRA にアクセスする

  • IDE を離れずに割り当てられた課題を表示

  • 1つのコマンドで特定の問題に関する詳細情報を取得

  • JIRA の問題をシームレスにローカルタスクに変換

• ⏰システム時間の統合

  • カスタマイズ可能な日付と時刻のフォーマット

  • date-fns によるロケールサポート

Related MCP server: JIRA MCP Server

🚀 クイックスタート

インストール

# 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 サーバーをテストします。

1. サーバーを構築して実行します。

   npm run build  # You must build the project before running it
   node dist/index.js

2. Claude デスクトップを設定します。

   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

3. 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"
         }
       }
     }
   }

4. 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ツール

システム時間ツール

📁 プロジェクト構造

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

NPMスクリプト

📘 リソース

• モデルコンテキストプロトコルドキュメント

• MCP TypeScript SDK

• MCP仕様

• MCP検査官

📄 ライセンス

MIT © スタニスラフ・ステパネンコ