Linear MCP Server

Linear MCP サーバー

Linear 向けの Model Context Protocol（MCP）サーバーです。AI アシスタントから Linear のプロジェクト管理機能を利用できます。

機能

• リソース： 課題、プロジェクト、チーム、ユーザー、ロードマップ、ドキュメント、イニシアチブなどにアクセスできます
• ツール： 課題の作成と更新、プロジェクトの管理、検索、プロジェクトとイニシアチブのリンクができます
• プロンプト： 課題の作成、バグ報告、機能リクエストなどのテンプレートを提供します

セットアップ

前提条件

• Node.js 18 以降
• Linear API キー

インストール

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

   git clone https://github.com/yourusername/linear-mcp.git
   cd linear-mcp
   

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

   npm install
   

3. Linear API キーを記載した .env ファイルを作成します：

   LINEAR_API_KEY=your_linear_api_key_here
   

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

   npm run build
   

使用方法

コマンドライン（stdio）

stdio トランスポートを使用してサーバーを実行するには（MCP に対応した CLI ツールで使用する場合）：

npm start

または：

node dist/index.js stdio

HTTP サーバー（リモート接続用）

Server-Sent Events（SSE）を使用する HTTP サービスとしてサーバーを実行するには：

node dist/index.js http

これにより、ポート 3000 で HTTP サーバーが起動します（PORT 環境変数で変更できます）。

開発モード

自動リロードを有効にして開発モードで実行するには：

npm run dev

Claude Desktop との連携

このサーバーを Claude Desktop で使用するには：

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

   npm run build
   

2. Claude Desktop で「Settings → Advanced → MCP Configuration」の順に開きます。

3. 次の設定を追加します（インストール先に合わせてパスを変更してください）：

   {
     "mcpServers": {
       "linear": {
         "command": "node",
         "args": [
           "/path/to/linear-mcp/dist/index.js"
         ],
         "env": {
           "LINEAR_API_KEY": "your_linear_api_key_here"
         }
       }
     }
   }
   

4. 設定を保存し、Claude Desktop を再起動します。

または、付属の claude-desktop-config.json ファイルをコピーし、インストール先に合わせてパスを変更することもできます。

リソース

このサーバーは、主要な Linear エンティティすべてにリソースとしてアクセスできます：

コアリソース

• 課題： linear://issues および linear://issues/{id}
• チーム： linear://teams および linear://teams/{id}
• プロジェクト： linear://projects および linear://projects/{id}
• ユーザー： linear://users および linear://users/{id}
• イニシアチブ： linear://initiatives および linear://initiatives/{id}

その他のリソース

• ロードマップ： linear://roadmaps および linear://roadmaps/{id}
• マイルストーン： linear://milestones および linear://milestones/{id}
• ドキュメント： linear://documents および linear://documents/{id}
• インテグレーション： linear://integrations および linear://integrations/{id}
• 組織： linear://organization

専用リソース

• linear://teams/{teamId}/issues - 特定のチームの課題
• linear://users/{userId}/issues - 特定のユーザーに割り当てられた課題
• linear://projects/{projectId}/issues - 特定のプロジェクトの課題
• linear://teams/{teamId}/states - チームのワークフロー状態
• linear://teams/{teamId}/labels - チームのラベル
• linear://teams/{teamId}/cycles - チームのサイクル
• linear://teams/{teamId}/members - チームのメンバー
• linear://teams/{teamId}/documents - チームのドキュメント
• linear://projects/{projectId}/documents - プロジェクトのドキュメント
• linear://projects/{projectId}/initiative - プロジェクトに関連付けられたイニシアチブ
• linear://initiatives/{initiativeId}/projects - イニシアチブに関連付けられたプロジェクト
• linear://milestones/{milestoneId}/projects - マイルストーンのプロジェクト
• linear://organization/subscription - 組織のサブスクリプション詳細
• linear://organization/auth-services - 組織の認証サービス
• linear://integration-services - 利用可能なインテグレーションサービス

ツール

このサーバーは、次のツールを提供します：

• 課題管理

  • 新しい課題の作成
  • 既存の課題の更新
  • 課題へのコメントの追加

• プロジェクト管理

  • 新しいプロジェクトの作成
  • 既存のプロジェクトの更新
  • プロジェクトへの課題の追加

• イニシアチブ管理

  • イニシアチブの作成
  • プロジェクトとイニシアチブのリンク
  • プロジェクトとイニシアチブのリンク解除

• 検索機能

  • Linear エンティティ全体の包括的な検索
  • 特定の条件に合う課題の検索

プロンプト

サーバーは次のプロンプトテンプレートを提供します。

• 課題関連

  • 新しい課題の作成
  • バグレポートの作成
  • 機能リクエストの作成

• プロジェクト関連

  • 新しいプロジェクトの作成
  • 課題を含むプロジェクトの計画
  • プロジェクトのステータス更新の作成

テスト

MCP Inspector でテストします。

npx @modelcontextprotocol/inspector stdio -- npm start

または、HTTP モードで実行している場合は、ブラウザーで MCP Inspector を開き、サーバーの URL に接続します。

環境変数

• LINEAR_API_KEY（必須）：Linear API キー
• SERVER_PORT（任意）：HTTP サーバーのポート（デフォルト：3000）
• LOG_LEVEL（任意）：ログレベル（デフォルト：info）

ライセンス

MIT