MCP Server for Cursor Integration

Cursor 連携用 MCP サーバー

目次

• セットアップ
• 利用可能なツール
  • Jira ツール
    • get_ticket_by_key
    • transition_ticket
    • list_tickets_by_team_and_status
    • add_code_reviewer
    • list_tickets_by_sprint_and_team
  • Confluence ツール
    • test_confluence_connection
    • get_confluence_page
    • update_confluence_page
  • 図表ツール
    • generate_diagram
    • add_diagram_to_confluence
• プロジェクト構成
• 開発
• トラブルシューティング
• コントリビューション
• ライセンス

この MCP（Model Context Protocol）サーバーは、Cursor IDE で使用するための Jira、Confluence、図表生成機能との連携を提供します。

セットアップ

1. このリポジトリをクローンします

2. 依存関係をインストールします：

   npm install
   

3. 設定例をコピーします：

   cp .cursor/mcp.json.example .cursor/mcp.json
   

4. .cursor/mcp.json を認証情報に合わせて更新します：

   • Jira API トークン
   • Confluence API トークン
   • 両サービスのベース URL

5. Cursor からサーバーを起動します：

   • Cursor IDE を開きます
   • Settings（⌘,）に移動します
   • 「Cursor Settings」に移動します
   • 「MCP Server」で「Start Server」をクリックします
   • このプロジェクトのディレクトリを選択します

利用可能なツール

Jira ツール

get_ticket_by_key

キー（例：STK-1234）を指定して Jira チケットを取得します。

{
  key: string  // Jira ticket key
}

プロンプトの例：

• 「チケット STK-1234 の詳細を表示して」
• 「STOCK-5678 のステータスは？」
• 「チケット STK-9012 の情報を取得して」

transition_ticket

Jira チケットのステータスを変更します。

{
  key: string,    // Jira ticket key
  status: string  // Target status
}

プロンプトの例：

• 「チケット STK-1234 を Code Review に移動して」
• 「STOCK-5678 を Done に変更して」
• 「STK-9012 のステータスを In Progress に更新して」

list_tickets_by_team_and_status

特定のチームとステータスのチケットを一覧表示します。

{
  team: string,   // Team name (e.g., "EComm Demand")
  status: string  // Ticket status (e.g., "Code Review")
}

プロンプトの例：

• 「EComm Demand チームの Code Review チケットをすべて表示して」
• 「EComm LTV の In Progress チケットを一覧表示して」
• 「Stock チームで QA にあるチケットは？」

add_code_reviewer

1 件以上のチケットにコードレビュー担当者を追加します。

{
  keys: string[],  // Array of Jira ticket keys
  username: string // Username to add as reviewer
}

プロンプトの例：

• 「STK-1234 のレビュー担当者に adelmann を追加して」
• 「STOCK-5678 と STOCK-5679 のコードレビュー担当者に jsmith を設定して」
• 「次のチケットにコードレビュー担当者 mmiller を追加して：STK-1234、STK-1235」

list_tickets_by_sprint_and_team

特定のスプリントとチームのチケットを一覧表示します。

{
  sprint: string, // Sprint name (e.g., "STK Sprint 253")
  team: string    // Team name (e.g., "EComm LTV")
}

プロンプトの例：

• 「STK Sprint 253 の EComm LTV チケットを表示して」
• 「現在のスプリントの EComm Demand チケットをすべて一覧表示して」
• 「Stock チームの Sprint 254 には何がある？」

Confluence ツール

test_confluence_connection

Confluence への接続をテストします。

プロンプトの例：

• 「Confluence への接続をテストして」
• 「Confluence が動作しているか確認して」
• 「Confluence の認証情報を検証して」

get_confluence_page

ID を指定して Confluence ページを取得します。

{
  pageId: string,           // Confluence page ID
  format?: "markdown" | "html" | "both" // Output format (default: "markdown")
}

プロンプトの例：

• 「Confluence ページ 3506530385 を表示して」
• 「Wiki ページ 1234567890 の内容を取得して」
• 「Confluence ページ 9876543210 を HTML 形式で取得して」

update_confluence_page

新しい内容で Confluence ページを更新します。

{
  pageId: string,    // Confluence page ID
  content: string,   // HTML content to update the page with
  minorEdit?: boolean // Whether this is a minor edit (default: false)
}

プロンプトの例：

• 「Confluence ページ 3506530385 を新しい内容で更新して」
• 「この HTML で Wiki ページ 1234567890 を編集して」
• 「ページ 9876543210 のドキュメントを更新して」

注：Confluence ページに Mermaid 図を含めるには、Mermaid の内容を HTML マクロで囲みます：

<ac:structured-macro ac:name="html">
<ac:plain-text-body><![CDATA[<div>
    <script type="module" src="https://cdn.jsdelivr.net/npm/[email protected]/+esm"></script>
    <pre class="mermaid">
        [Your Mermaid diagram code here]
    </pre>
</div>]]></ac:plain-text-body>
</ac:structured-macro>

図表ツール

generate_diagram

Mermaid 構文を使用して図を生成し、画像として保存します。

{
  code: string,     // Mermaid diagram code
  filename?: string // Optional filename for the diagram
}

プロンプトの例：

• 「ユーザー認証フローを示すシーケンス図を作成して」
• 「Cart システムのクラス図を生成して」
• 「チェックアウトプロセスを示すフローチャートを作成して」
• 「このコードファイルから図を作成して」
• 「このクラスを分析して図を作成して」

Mermaid コードの例：

sequenceDiagram
    User->>+Server: Login Request
    Server->>+Database: Validate Credentials
    Database-->>-Server: Valid
    Server-->>-User: Success

add_diagram_to_confluence

Mermaid の図を Confluence ページに追加します。

{
  pageId: string,      // Confluence page ID
  mermaidCode: string, // Mermaid diagram code
  position?: string    // Where to add the diagram (top or bottom)
}

プロンプトの例：

• 「この図を Confluence ページ 3506530385 に追加して」
• 「シーケンス図をページ 1234567890 の先頭に挿入して」
• 「Wiki ページ 9876543210 をこのアーキテクチャ図で更新して」

プロジェクト構成

.
├── .cursor/              # Cursor configuration
│   ├── mcp.json         # Your configuration (not in git)
│   └── mcp.json.example # Example configuration
├── diagrams/            # Generated diagrams (contents not in git)
├── services/           # Service implementations
├── utils/             # Utility functions
├── middleware/        # Middleware components
└── server.js         # Main server file

開発

• 生成された図は diagrams/ ディレクトリに保存されますが、git では追跡されません
• サーバーは Node.js と MCP SDK を使用します
• すべてのツールは server.js に登録されています

トラブルシューティング

1. サーバーが起動しない場合：

   • .cursor/mcp.json が存在し、有効な認証情報が設定されていることを確認してください
   • 他の MCP サーバーが実行されていないことを確認してください
   • Cursor のコンソールでエラーメッセージを確認してください

2. Cursor にツールが表示されない場合：

   • Cursor の設定から MCP サーバーを再起動してください
   • ツールが server.js に正しく登録されていることを確認してください

3. 図の生成に失敗する場合：

   • @mermaid-js/mermaid-cli がグローバルにインストールされていることを確認してください：

     npm install -g @mermaid-js/mermaid-cli
     

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. プルリクエストを送信します

ライセンス

このプロジェクトは専有かつ機密です。© Adobe Systems Incorporated。