Linear MCP Server

Linear MCP サーバー

注：これはカスタム実装です。公式の Cline Linear MCP サーバーについては、cline/linear-mcpを参照してください。

Linear の API と連携するためのツールを提供する Model Context Protocol（MCP）サーバーです。AI エージェントが Linear プラットフォームを通じて、課題、プロジェクト、チームをプログラムから管理できるようにします。

機能

• 課題管理

  • カスタマイズ可能なプロパティ（タイトル、説明、チーム、担当者、優先度、ラベル）を指定して、新しい課題を作成します
  • 柔軟なフィルター（チーム、担当者、ステータス）を使って課題を一覧表示します
  • 既存の課題を更新します（タイトル、説明、ステータス、担当者、優先度）

• チーム管理

  • ワークスペース内のすべてのチームを一覧表示します
  • ID、名前、キー、説明などのチーム詳細を取得します

• プロジェクト管理

  • チームで絞り込んで、すべてのプロジェクトを一覧表示します
  • 名前、説明、状態、関連付けられたチームなどのプロジェクト詳細を表示します

前提条件

• Node.js（v16 以降）
• API にアクセスできる Linear アカウント
• 適切な権限を持つ Linear API キー

クイックスタート

1. Linear の開発者設定から Linear API キーを取得します

2. API キーを使って実行します：

LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp

または、環境に設定します：

export LINEAR_API_KEY=your-api-key
npx @ibraheem4/linear-mcp

開発環境のセットアップ

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

git clone [repository-url]
cd linear-mcp

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

npm install

3. プロジェクトをビルドします：

npm run build

Inspector を使った実行

ローカルでの開発やデバッグには、MCP Inspector を使用できます：

1. supergateway をインストールします：

npm install -g supergateway

2. 同梱の run.sh スクリプトを使用します：

chmod +x run.sh
LINEAR_API_KEY=your-api-key ./run.sh

3. Inspector にアクセスします：
   • ブラウザーでlocalhost:1337を開きます
   • Inspector は Server-Sent Events（SSE）経由で接続します
   • Inspector のインターフェースからツールの呼び出しをテスト、デバッグします

設定

使用するクライアントに応じて、設定ファイルで MCP サーバーを設定します：

Claude Desktop の場合

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

VS Code 拡張機能（Cline）の場合

場所：~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Cursor（cursor.sh）の場合

Cursor では、サーバーをフルパスで実行する必要があります：

node /Users/ibraheem/Projects/linear-mcp/build/index.js

利用可能なツール

create_issue

Linear に新しい課題を作成します。

{
  title: string;          // Required: Issue title
  description?: string;   // Optional: Issue description (markdown supported)
  teamId: string;        // Required: Team ID
  assigneeId?: string;   // Optional: Assignee user ID
  priority?: number;     // Optional: Priority (0-4)
  labels?: string[];     // Optional: Label IDs to apply
}

list_issues

任意のフィルターを指定して課題を一覧表示します。

{
  teamId?: string;      // Optional: Filter by team ID
  assigneeId?: string;  // Optional: Filter by assignee ID
  status?: string;      // Optional: Filter by status
  first?: number;       // Optional: Number of issues to return (default: 50)
}

update_issue

既存の課題を更新します。

{
  issueId: string;       // Required: Issue ID
  title?: string;        // Optional: New title
  description?: string;  // Optional: New description
  status?: string;      // Optional: New status
  assigneeId?: string;  // Optional: New assignee ID
  priority?: number;    // Optional: New priority (0-4)
}

list_teams

ワークスペース内のすべてのチームを一覧表示します。パラメーターは不要です。

list_projects

任意のフィルターを指定して、すべてのプロジェクトを一覧表示します。

{
  teamId?: string;     // Optional: Filter by team ID
  first?: number;      // Optional: Number of projects to return (default: 50)
}

get_issue

特定の課題の詳細情報を取得します。

{
  issueId: string; // Required: Issue ID
}

開発

自動再ビルドを有効にして開発する場合：

npm run watch

エラー処理

このサーバーは、以下のエラーに対する包括的なエラー処理を備えています：

• 無効な API キー
• 必須パラメーターの不足
• Linear API のエラー
• 無効なツールリクエスト

すべてのエラーは適切な形式に整えられ、内容を説明するメッセージとともに返されます。

技術詳細

使用技術：

• TypeScript
• Linear SDK (@linear/sdk v37.0.0)
• MCP SDK (@modelcontextprotocol/sdk v0.6.0)

このサーバーは stdio を使って通信し、AI エージェントとシームレスに統合するために Model Context Protocol を実装しています。

ライセンス

MIT