リニアMCP統合サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を介してLinearとの統合機能を提供します。これにより、AIモデルはLinearと連携して問題追跡やプロジェクト管理を行うことができます。

特徴

サーバーは、MCP インターフェイスを通じて次のツールを提供します。

線形作成問題

次のパラメータを使用して新しい線形問題を作成します。

• title （必須）: 問題のタイトル
• teamId (必須): 問題を作成するチームID
• description （オプション）: 問題の説明（マークダウン対応）
• priority （オプション）：優先度（0～4）
• status （オプション）: 初期ステータス名

線形探索の問題

柔軟なフィルタリングで線形問題を検索:

• query （オプション）: タイトル/説明で検索するテキスト
• teamId (オプション): チームでフィルタリング
• status （オプション）: ステータスでフィルタリング
• assigneeId (オプション): 担当者によるフィルタリング
• priority （オプション）：優先度（0～4）
• limit （オプション、デフォルト：10）：返される結果の最大数

リニアスプリントの問題

現在のスプリント/イテレーション内のすべての問題を取得します。

• teamId (必須): スプリントの問題を取得するチームID

線形探索チーム

リニア チームの検索と取得:

• query （オプション）: チーム名で検索するテキスト

リニアフィルタースプリント問題

現在のスプリントの問題をステータス別にフィルタリングし、現在のユーザーに自動的にフィルタリングします。

• teamId (必須): スプリントの問題を取得するチームID
• status (必須): フィルタリングするステータス (例: 「製品リリース保留中」)

linear_get_workflow_states

チームで利用可能なすべてのワークフロー状態 (ステータス) を取得します。

• teamId (必須): ワークフローの状態を取得するためのチームID

線形リストプロジェクト

利用可能なすべてのプロジェクトとその ID のリストを取得します。

• teamId (オプション): チーム別にプロジェクトをフィルタリングするためのチームID
• limit （オプション、デフォルト：50）：返されるプロジェクトの最大数

開発者向けセットアップ

1. Linearの設定 > APIセクションからLinear APIキーを取得します。
2. 環境の例をコピーする :
   cp .env.example .env
3. API Linear を変更して le fichier .env et ajoutez votre clé API を変更します。
   LINEAR_API_KEY=votre_clé_api_linear_ici
4. 依存関係をインストールします:
   npm install
5. サーバーを起動します。
   # Development mode with auto-reload npm run dev # Production mode npm start # Build TypeScript npm run build # Run linter npm run lint # Run tests npm run test # Inspect MCP server npm run inspect

GitHub からプロジェクトをクローンした場合の Docker セットアップ

このアプリケーションは Docker を使用して実行することもできます。

1. システムにDockerとDocker Composeがインストールされていることを確認してください
2. 上記のように、Linear APIキーを使用して.envファイルを作成します。
3. コンテナをビルドして起動します。
   # Build and start the container in detached mode docker-compose up -d # View logs docker-compose logs -f # Stop the container docker-compose down
4. サーバーはコンテナ内で実行され、明示的に停止されない限り自動的に再起動します。

Docker の使用 (docker-compose を使用した簡略化された方法)

1. Linear API キーを使用して.envファイルを作成します。
   LINEAR_API_KEY=your_linear_api_key_here
2. docker-compose.ymlファイルを作成します。
   version: '3.8' services: mcp-linear-server: image: madebynando/mcp-linear-server:latest container_name: mcp-linear-server restart: unless-stopped env_file: - .env volumes: - ./logs:/app/logs
3. コンテナを起動します。
   docker-compose up -d
4. カーソルを設定するには、次を使用します。
   • トランスポートタイプ: コマンド
   • コマンド: docker exec -i mcp-linear-server node dist/server.js

Docker開発

Docker を使用した開発の場合:

技術的な詳細

• TypeScriptとモデルコンテキストプロトコルSDKを使用して構築
• APIインタラクションにはLinear SDKを使用する
• エラー処理、レート制限、接続管理が含まれます
• 設定可能な再試行回数による自動再接続をサポート
• 接続の健全性を監視するハートビート監視を実装
• デバッグモードで詳細なログを提供します

エラー処理

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

• APIタイムアウト保護
• 接続が失われた場合の自動再接続試行
• タイムスタンプ付きの詳細なエラーログ
• 正常なシャットダウン処理
• 接続の健全性を監視するハートビート監視

依存関係

• @linear/sdk : リニア API クライアント
• @modelcontextprotocol/sdk : MCP サーバーの実装
• zod : 実行時の型チェックと検証
• dotenv : 環境変数の管理
• TypeScriptおよび関連開発ツール

依存関係の完全なリストについては、 package.json参照してください。

カーソルでの使用

このサーバーを Cursor で使用するには、MCP サーバーとして追加できます。

Dockerなし

警告： CursorでMCPサーバーを追加する際は、コマンドにLINEAR_API_KEY直接設定してください。これは、サーバーがLinear APIを正しく認証し、操作するために不可欠です。設定しないと認証エラーが発生し、サーバーは期待どおりに動作しなくなります。

例：

env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js

1. カーソル設定メニューを開く
2. 「MCPサーバー」セクションへ移動
3. 「MCPサーバーを追加」をクリックします
4. 次の詳細を入力してください。
   • 名前: linear-mcp-server
   • トランスポートタイプ: コマンド
   • コマンド: env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js
5. 「保存」をクリック
6. これで、カーソルのツール リストに線形ツールが表示されるようになります。

Dockerを使用

1. カーソル設定メニューを開く
2. 「MCPサーバー」セクションへ移動
3. 「MCPサーバーを追加」をクリックします
4. 次の詳細を入力してください。
   • 名前: linear-mcp-server
   • トランスポートタイプ: コマンド
   • コマンド: docker exec -i mcp-linear-server node dist/server.js
5. 「保存」をクリック
6. これで、カーソルのツール リストに線形ツールが表示されるようになります。

クロードに指導する

Claude にこの MCP サーバーを使用するように指示する場合は、次のエンドポイントを参照できます。

タイトル、説明、チーム ID、優先度、ステータスを指定して新しい Linear 問題を作成します。

クエリ、チーム、ステータス、担当者、優先度、制限による柔軟なフィルタリングを使用して、線形の問題を検索します。

特定のチームの現在のスプリント/イテレーション内のすべての問題を取得します。

名前でリニア チームを検索して取得します。

特定のチームの現在のスプリントの問題をステータス別にフィルタリングします。

特定のチームの利用可能なすべてのワークフロー状態 (ステータス) を取得します。

利用可能なすべてのプロジェクトのリストを ID 付きで取得します。オプションでチーム別にフィルタリングすることもできます。