Linear MCP Server Again

🚀 線形MCPサーバー

このプロジェクトは、Model Context Protocol (MCP) サーバーを実装しており、Claudeと線形タスク/問題管理システムの橋渡しとして機能します。Claudeが以下のツールを通じて線形とやり取りできるようにします。

1. get_ticket - 特定の線形チケットの詳細情報を取得します。
2. get_my_issues - 現在のユーザーに割り当てられた線形問題をリストし、状態でフィルタリングします。
3. add_comment - 線形チケットにコメントを追加します。
4. create_issue - 線形で新しい問題を作成します。
5. get_teams - 参考用に利用可能なチームを取得します。

🚀 クイックスタート

このサーバーは、標準入出力（stdio）を通じてMCPプロトコルを使用してClaudeと通信します。以下が必要です。

• 線形APIキー（コード内で設定）
• Node.js実行環境
• パッケージJSONで指定された依存関係

✨ 主な機能

チケット検索

• 状態、優先度、担当者、チームを含む包括的なチケット詳細を取得します。
• 完全な説明とすべてのコメントを検索します。
• 埋め込み画像を含むMarkdownコンテンツを処理します。
• チケット説明内の画像をダウンロードして含めます。

問題リスト

• 現在のユーザーに割り当てられた問題を検索します。
• 状態（アクティブ、待機、完了、キャンセル、またはすべて）でフィルタリングします。
• 各問題の重要な情報を含む形式の表を返します。

コメント追加

• 既存のチケットに新しいコメントを追加できます。
• コメントの作成が成功したことを確認するメッセージを提供します。

📦 インストール

直接のインストールは必要ありません。正しく設定すると、このパッケージは自動的にダウンロードされ、Claudeの統合で使用されます。

💻 使用例

基本的な使用法

1. Linearアカウント設定 から線形APIキーを取得します。「個人用APIキー」の下の「新しいAPIキー」をクリックします。
2. コードエディタでMCPサーバーを以下のように設定します。

VS Codeを使用する場合

• get_ticket
  • パラメータ: ticketId (文字列)
  • 出力: チケットの詳細情報、コメント、埋め込み画像を含むJSONオブジェクト
• get_my_issues
  • パラメータ: state (オプションの文字列、デフォルトは "active")
  • 出力: 現在のユーザーの問題の表形式のリスト、優先度で並べられます。
• add_comment
  • パラメータ: ticketId (文字列) と comment (文字列)
  • 出力: 成功確認メッセージ
• create_issue
  • パラメータ: title (文字列)、description (文字列)、priority (文字列、デフォルトは "normal")、assigneeId (オプションの文字列)、および teamId (オプションの文字列)
  • 出力: 作成された問題の詳細情報

VS Code拡張機能Clineを使用する場合

MCP設定JSONファイルに以下の内容を追加します。

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "@larryhudson/linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "<YOUR_API_KEY>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

📚 ドキュメント

環境変数

• LINEAR_API_KEY - あなたの線形APIキー（必須）

仕組み

このサーバーは以下の主要技術に基づいて構築されています。

• Model Context Protocol (MCP) - AIアシスタントが外部ツールやAPIとやり取りできるようにするフレームワーク
• 線形SDK - 線形APIと通信するためのクライアントライブラリ
• Node.js - JavaScript実行環境
• Zod - ツールパラメータの型検証ライブラリ

🔧 技術詳細

画像処理

• 正規表現を使用してMarkdownから画像URLを抽出します。
• 画像をローカルの一時ディレクトリにダウンロードします。
• 画像をbase64に変換してMCP応答に含めます。
• URLのMD5チェックサムを使用して一意のファイル名を生成します。

線形API統合

• 線形APIキーを使用して認証します。
• 問題、チケット、コメント、ユーザー情報を検索します。
• データを人間が読める形式に整形して表示します。

エラー処理

• APIエラー、欠落したチケット、ダウンロード失敗を適切に処理します。
• ユーザーに意味のあるエラーメッセージを提供します。

プロジェクト構造

これは比較的シンプルなNode.jsアプリケーションで、主要なソースファイルは1つ (index.ts) で、MCPサーバー、ツール、および関連するヘルパー関数を定義しています。TypeScriptを使用して型安全性と開発者体験を向上させています。

依存関係

• @modelcontextprotocol/sdk: MCP実装の核心
• @linear/sdk: 線形APIクライアント
• dotenv: 環境変数管理
• node-fetch: 画像ダウンロードのHTTPクライアント
• zod: ツールパラメータのスキーマ検証

制限事項と潜在的な改善点

• 大量のデータ結果セットに対するページングサポートは限られています（現在は20個の問題に制限）。
• エラー処理は、より多くのエッジケースに対応するように改善できます。
• 画像ダウンロードは、より良いMIMEタイプ検出によって恩恵を受けることができます。
• 問題を管理するための追加ツール（状態の更新、担当者の変更など）の追加を検討してください。
• 問題の作成またはコメントの追加時の添付ファイルをサポートするようにします。