Linear Integration Server

🚀 Linear MCP サーバー

このサーバーは、Linear API 用の Model Context Protocol サーバーです。Linear の問題追跡システムとの統合を実現し、大規模言語モデル (LLM) がこのシステムと相互作用できるようになります。

🚀 クイックスタート

このサーバーを使用することで、LLM が Linear の問題追跡システムと連携でき、問題の作成や更新、検索などの操作を自動化することが可能です。

📦 インストール

Smithery を使用したインストール

Smithery を通じて、Claude Desktop 用の Linear Integration Server を自動的にインストールできます。

npx -y @smithery/cli install @gerbal/linear-mcp-server-1 --client claude

手動インストール

1. チーム用の Linear API キーを作成または取得します。https://linear.app/YOUR-TEAM/settings/api
2. サーバーの設定を Claude Desktop に追加します。
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

📚 ドキュメント

ツール

1. linear_create_issue：新しい Linear の問題を作成します。

   • 必須パラメータ：
     • title (文字列)：問題のタイトル
     • teamId (文字列)：問題を作成するチームの ID
   • オプションパラメータ：
     • description (文字列)：問題の説明（Markdown をサポート）
     • priority (数字, 0-4)：優先度レベル（1=緊急，4=低）
     • status (文字列)：初期状態の名前

2. linear_update_issue：既存の問題を更新します。

   • 必須パラメータ：
     • id (文字列)：更新する問題の ID
   • オプションパラメータ：
     • title (文字列)：新しいタイトル
     • description (文字列)：新しい説明
     • priority (数字)：新しい優先度
     • status (文字列)：新しい状態の名前

3. linear_search_issues：柔軟なフィルターを使用して問題を検索します。

   • オプションパラメータ：
     • query (文字列)：タイトル/説明内で検索するテキスト
     • teamId (文字列)：チームでフィルター
     • status (文字列)：状態でフィルター
     • assigneeId (文字列)：担当者でフィルター
     • labels (文字列配列)：ラベルでフィルター
     • priority (数字)：優先度でフィルター
     • limit (数字，デフォルト値は 10)：最大結果数

4. linear_get_user_issues：ユーザーに割り当てられた問題を取得します。

   • オプションパラメータ：
     • userId (文字列)：ユーザー ID（省略すると認証済みユーザーを意味します）
     • includeArchived (ブール値)：アーカイブされた問題を含めるかどうか
     • limit (数字，デフォルト値は 50)：最大結果数

5. linear_add_comment：問題にコメントを追加します。

   • 必須パラメータ：
     • issueId (文字列)：コメントする問題の ID
     • body (文字列)：コメント内容（Markdown をサポート）
   • オプションパラメータ：
     • createAsUser (文字列)：コメントを作成するユーザー
     • anonymous (ブール値)：匿名でコメントするかどうか

リソース

• Linear API ドキュメント

🔧 開発

1. 依存関係をインストールします。

npm install

2. .env ファイルに Linear API キーを設定します。

LINEAR_API_KEY=your_api_key_here

3. サーバーをビルドします。

npm run build

開発中に自動的に再ビルドするには、以下のコマンドを使用します。

npm run watch

📄 ライセンス

この MCP サーバーは MIT License の下で公開されています。これにより、ソフトウェアを自由に使用、変更、配布することができますが、MIT License の条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。