Madebynando MCP Linear Server

🚀 Linear MCP 統合サーバー

Linear MCP 統合サーバーは、Linear ツールを接続および統合するためのミドルウェアです。これは、モデルコンテキストプロトコル（Model Context Protocol）を通じて Claude などの AI モデルとの対話を実現し、Linear プロジェクト内の問題やタスクを作成、検索、管理するための一連の機能を提供します。

✨ 主な機能

ツールエンドポイント

• linear_create_issue

  • タイトル、説明、チーム ID、優先度、状態をサポートして、新しい Linear 問題を作成します。

• linear_search_issues

  • クエリ条件、チーム、状態、担当者、優先度、制限数に基づいて、Linear 問題を検索します。

• linear_sprint_issues

  • 指定されたチームの現在のスプリントまたはイテレーション中のすべての問題を取得します。

• linear_search_teams

  • 名前でフィルタリングして、Linear チームを検索および取得します。

• linear_filter_sprint_issues

  • 状態に基づいて、指定されたチームの現在のスプリントまたはイテレーション中の問題をフィルタリングします。

• linear_get_workflow_states

  • 指定されたチームのすべての利用可能なワークフロー状態（つまり、問題の状態）を取得します。

• linear_list_projects

  • チームでフィルタリング可能な、すべてのプロジェクトのリストとその ID を取得します。

📦 インストール

開発者設定

環境構成

1. Node.js と npm をダウンロードしてインストールします。
2. config フォルダを作成し、その中に env ファイルを追加します：

   LINEAR_API_KEY=your_linear_api_key
   

3. プロジェクトのルートディレクトリに package.json ファイルを作成し、以下の内容を記述します：

   {
     "name": "linear-mcp-server",
     "version": "1.0.0",
     "scripts": {
       "start": "node dist/server.js"
     },
     "dependencies": {
       "@linear/sdk": "^2.0.0",
       "@modelcontextprotocol/sdk": "^1.0.0",
       "zod": "^1.0.0",
       "dotenv": "^16.3.1"
     }
   }
   

依存関係のインストール

プロジェクトのルートディレクトリで以下のコマンドを実行して、必要な依存関係をインストールします：

npm install

サーバーの起動

以下のコマンドを使用して、MCP サーバーを起動します：

npm start

Docker 設定

イメージの構築

Dockerfile ファイルを作成し、以下の内容を記述します：

FROM node:16

WORKDIR /app

COPY package.json ./
COPY config/ ./

RUN npm install

CMD ["node", "dist/server.js"]

Compose ファイル

docker-compose.yml ファイルを作成し、以下の内容を記述します：

version: '3'
services:
  mcp-server:
    build: .
    ports:
      - "8080:8080"
    environment:
      - LINEAR_API_KEY=your_linear_api_key

サービスの起動

以下のコマンドを実行して、Docker サービスを起動します：

docker-compose up --build

🔧 技術詳細

• 技術スタック：Node.js をベースに、Linear SDK と MCP プロトコルを使用して実装されています。
• エラー処理：API タイムアウト保護、自動再接続、詳細なログ記録、エレガントなシャットダウン処理を含みます。
• 監視とメンテナンス：接続の健全性を確保するためのハートビート監視を提供します。

💻 使用例

Cursor での使用

Docker なしの設定

1. Cursor の設定メニューを開きます。
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. 設定を保存します。

Docker を使用した設定

1. Cursor の設定メニューを開きます。
2. “MCP サーバー” セクションに移動します。
3. “MCP サーバーを追加” をクリックします。
4. 以下の情報を入力します：
   • 名前：linear-mcp-server
   • トランスポートタイプ：コマンドライン
   • コマンド：docker exec -i mcp-linear-server node dist/server.js
5. 設定を保存します。

Claude の使用指示

Claude は、以下の MCP エンドポイントを介して Linear と対話できます：

問題の作成

linear_create_issue エンドポイントを使用して新しい問題を作成します：

POST /api/linear/create-issue
Content-Type: application/json

{
  "title": "問題タイトル",
  "description": "問題説明",
  "teamId": "チームID",
  "priority": "優先度",
  "status": "状態"
}

問題の検索

linear_search_issues エンドポイントを使用して問題を検索します：

GET /api/linear/search-issues?query=クエリ条件

応答例

{
  "id": "12345",
  "title": "機能開発タスク",
  "description": "新しいユーザー認証モジュールを実装する",
  "teamId": "001",
  "priority": "高",
  "status": "進行中"
}

📄 注意事項

⚠️ 重要提示

LINEAR_API_KEY が正しく設定され、有効であることを確認してください。 依存関係を定期的にチェックして更新し、最新の機能とセキュリティパッチを取得してください。 本番環境では、エラー処理とログ記録メカニズムを設定することをおすすめします。