Linear

🚀 線形MCPサーバー

このサーバーは、線形（Linear）とのやり取りを行うためのModel Context Protocol (MCP) サーバーです。AIアシスタントがMCP標準を通じて線形からデータを取得できるようにします。

✨ 主な機能

• 指定したユーザーの未着手のチケットを取得できます。ユーザーIDまたはメールアドレスで検索できます。

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. プロジェクトのルートディレクトリに .env ファイルを作成します（.env.example テンプレートに基づいて）。

   LINEAR_API_KEY=あなたの線形APIキー
   

   線形開発者コンソール から線形APIキーを取得してください。

📚 ドキュメント

開発環境での実行

ホットリロード機能付きで開発サーバーを起動します。

npm run dev

本番環境でのビルド

TypeScriptコードをビルドします。

npm run build

ビルド後のプログラムを実行します。

npm start

MCPクライアントとの連携

このMCPサーバーは標準のMCPプロトコルを実装しており、任意のMCPクライアントと連携できます。サーバーが提供するツールは以下の通りです。

基本的な使用法

Claude Codeとこの線形MCPサーバーを連携させるには、以下のコマンドを実行します。

claude mcp add linear-mcp-server -- node dist/index.js

これにより、線形MCPサーバーがClaude Codeに登録され、Claudeの会話から直接線形チケットにアクセスできるようになります。

高度な使用法

指定したユーザーの「Todo」状態のすべてのチケットを取得します。

パラメータ:

• userId（オプション）: ユーザーのID
• email（オプション）: ユーザーのメールアドレス

注意: userId または email のいずれかを指定する必要があります。

サンプルレスポンス:

[
  {
    "id": "issue-id",
    "identifier": "PROJ-123",
    "title": "ログイン問題を修正する",
    "url": "https://linear.app/...",
    "priority": 1
  },
  ...
]

🤝 コントリビューション

コントリビューションを歓迎します！自由にプルリクエストを送信してください。