リニアMCPサーバー

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

Linear の API と対話するためのツールを提供するモデルコンテキストプロトコル (MCP) サーバー。AI エージェントが Linear プラットフォームを通じてプログラムで問題、プロジェクト、チームを管理できるようになります。

特徴

問題管理
- カスタマイズ可能なプロパティ（タイトル、説明、チーム、担当者、優先度、ラベル）を使用して新しい問題を作成します。
- 柔軟なフィルタリングオプション (チーム、担当者、ステータス) を使用して問題を一覧表示します
- 既存の問題を更新する（タイトル、説明、ステータス、担当者、優先度）
チームマネジメント
- ワークスペース内のすべてのチームを一覧表示する
- ID、名前、キー、説明などのチームの詳細にアクセスします
プロジェクト管理
- オプションのチームフィルタリングを使用してすべてのプロジェクトを一覧表示します
- 名前、説明、状態、関連チームなどのプロジェクトの詳細を表示します

前提条件

Node.js (v16 以上)
APIアクセス可能なLinearアカウント
適切な権限を持つリニアAPIキー

クイックスタート

Linearの開発者設定からLinear APIキーを取得します
API キーを使用して実行します:

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

または、環境内で設定します。

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

開発セットアップ

リポジトリをクローンします。

git clone [repository-url]
cd linear-mcp

依存関係をインストールします:

npm install

プロジェクトをビルドします。

npm run build

Inspectorで実行する

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

スーパーゲートウェイをインストールします。

npm install -g supergateway

付属のrun.shスクリプトを使用します。

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

インスペクターにアクセスします。
- ブラウザでlocalhost:1337を開きます
- インスペクターはサーバー送信イベント（SSE）を介して接続します。
- インスペクタインターフェースを介したテストおよびデバッグツールの呼び出し

構成

クライアントに基づいて設定ファイルで MCP サーバーを構成します。

クロードデスクトップ向け

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.sh )

カーソルの場合、サーバーはフルパスで実行する必要があります。

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

利用可能なツール

問題作成

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
}

リストの問題

オプションのフィルターを使用して問題を一覧表示します。

{
  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)
}

更新問題

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

{
  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)
  labels?: string[];   // Optional: Label IDs to apply to the issue
}

チームリスト

ワークスペース内のすべてのチームを一覧表示します。パラメータは必要ありません。

プロジェクト一覧

オプションのフィルタリングを使用してすべてのプロジェクトを一覧表示します。

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

発行を取得

特定の問題に関する詳細情報を取得します。

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

発達

自動リビルドを使用した開発の場合:

npm run watch

エラー処理

サーバーには、次の包括的なエラー処理が含まれています。

無効なAPIキー
必要なパラメータが不足しています
リニアAPIエラー
無効なツールリクエスト

すべてのエラーは適切にフォーマットされ、説明的なメッセージとともに返されます。

技術的な詳細

搭載コンポーネント:

タイプスクリプト
リニア SDK (@linear/sdk v37.0.0)
MCP SDK（@modelcontextprotocol/sdk v0.6.0）

サーバーは通信に stdio を使用し、AI エージェントとのシームレスな統合のためにモデルコンテキストプロトコルを実装します。

ライセンス

マサチューセッツ工科大学

Linear MCP Server

Integrations