Linear MCP Server

Linear MCP サーバー

概要

このプロジェクトは、Claude と Linear のタスク／課題管理システムをつなぐブリッジとして機能する Model Context Protocol（MCP）サーバーを実装します。Claude は、以下のツールを通じて Linear とやり取りできます。

1. get_ticket - 特定の Linear チケットの詳細情報を取得します
2. get_my_issues - 状態による絞り込みを指定して、現在のユーザーに割り当てられている課題の一覧を取得します
3. add_comment - Linear チケットにコメントを追加します
4. create_issue - Linear に新しい課題を作成します
5. get_teams - 参照用に利用可能なチームを取得します

インストール

直接インストールする必要はありません。適切に設定すると、Claude との連携時にパッケージが自動的にダウンロードされ、使用されます。

使い方

1. Linear のアカウント設定から Linear API キーを取得します。「Personal API keys」の下にある「New API key」をクリックしてください。

2. 以下のように、コードエディターで MCP サーバーを設定します。

VS Code での使用

ワンクリックでインストール：

以下を設定 JSON ファイルに追加します。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "linear_api_key",
        "description": "Linear API Key",
        "password": true
      }
    ],
    "servers": {
      "linear": {
        "command": "npx",
        "args": [
          "-y",
          "@larryhudson/linear-mcp-server"
        ],
        "env": {
          "LINEAR_API_KEY": "${input:linear_api_key}"
        }
      }
    }
  }
}

Cursor IDE での使用

以下を MCP 設定 JSON ファイルに追加します。

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@larryhudson/linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Claude Desktop アプリでの使用

以下を MCP 設定 JSON ファイルに追加します。

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "@larryhudson/linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Cline VS Code 拡張機能での使用

以下を MCP 設定 JSON ファイルに追加します。

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@larryhudson/linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "<YOUR_API_KEY>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

環境変数

• LINEAR_API_KEY - Linear API キー（必須）

仕組み

サーバーは、以下の主要技術を基盤としています。

• Model Context Protocol (MCP) - AI アシスタントが外部のツールや API とやり取りできるようにするフレームワーク
• Linear SDK - Linear API と通信するためのクライアントライブラリ
• Node.js - JavaScript ランタイム環境
• Zod - ツールのパラメーターを検証するための型検証ライブラリ

主な機能

チケットの取得

• ステータス、優先度、担当者、チームなど、チケットの包括的な詳細情報を取得します
• チケットの全文とすべてのコメントを取得します
• 画像が埋め込まれた Markdown コンテンツを処理します
• チケットの説明に含まれる画像をダウンロードして取り込みます

課題の一覧表示

• 現在のユーザーに割り当てられている課題を取得します
• 状態（アクティブ、バックログ、完了、キャンセル、またはすべて）で絞り込みます
• 各課題の主要情報を含む、書式設定された表を返します

コメントの追加

• 既存のチケットに新しいコメントを追加できます
• コメントが正常に作成されたことを確認できます

技術的な実装の詳細

1. 画像の処理

   • 正規表現を使用して Markdown から画像 URL を抽出します
   • 画像をローカルの一時ディレクトリにダウンロードします
   • MCP レスポンスに含めるため、画像を Base64 に変換します
   • URL の MD5 ハッシュを使用して一意のファイル名を作成します

2. Linear API との連携

   • Linear API キーを使用して認証します
   • イシュー、チケット、コメント、ユーザー情報を取得します
   • 人が読みやすい形式にデータを整形します

3. エラー処理

   • API エラー、チケットの欠落、ダウンロードの失敗を適切に処理します
   • ユーザーにわかりやすいエラーメッセージを表示します

サーバーの実行

サーバーは MCP プロトコルを使用し、標準入力／出力（stdio）を介して Claude と通信します。必要なものは次のとおりです。

• Linear API キー（コード内で設定）
• Node.js 実行環境
• package.json で指定されている依存パッケージ

プロジェクト構成

これは、MCP サーバー、ツール、および関連するヘルパー関数を定義する単一のメインソースファイル（index.ts）を含む、比較的シンプルな Node.js アプリケーションです。型安全性と開発者体験の向上のために TypeScript を使用しています。

依存関係

• @modelcontextprotocol/sdk：MCP のコア実装
• @linear/sdk：Linear API クライアント
• dotenv：環境変数の管理
• node-fetch：画像ダウンロード用の HTTP クライアント
• zod：ツールパラメーターのスキーマ検証

制限事項と改善の可能性

• 大量の結果に対するページネーションのサポートが限定的です（現在、イシューは 20 件までです）
• さまざまなエッジケースへのエラー処理を改善できる可能性があります
• 画像ダウンロードでは、MIME タイプの検出を改善できる可能性があります
• イシューを管理するツール（ステータスの更新、担当者の変更など）の追加を検討してください
• イシューの作成時やコメントの追加時に添付ファイルをサポートしてください