Linear MCP Server

🚀 線形MCPサーバー

線形リソースへのアクセスインターフェースを提供する線形モデルコンテキストプロトコル（MCP）サーバーの実装です。

🚀 クイックスタート

📦 インストール

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

git clone git@github.com:Iwark/linear-mcp-server.git
cd linear-mcp-server
npm install

2. 起動スクリプトを作成します。

# linear.sh スクリプトを作成
touch linear.sh
chmod +x linear.sh

# 以下の内容を追加
export LINEAR_API_KEY="YOUR LINEAR API KEY"
node /絶対パス/linear-mcp-server/index.js

3. カーソルで設定を行います。

• カーソル設定を開きます。
• MCPサーバーの部分に新しいサーバーを追加します。
• タイプを Command に選択します。
• コマンドを sh /絶対パス/linear.sh に設定します。

これでカーソル内で線形MCPサーバーを使用できます。

線形APIキーは線形設定ページから取得できます。

4. サーバーを起動します。

npm start

💻 使用例

利用可能なツール

create-issue

新しい線形問題を作成します。指定可能なパラメータは以下の通りです。

• title（必須）：問題のタイトル
• teamId（必須）：チームID
• description（任意）：問題の説明
• priority（任意）：問題の優先度（0: 無優先度, 1: 緊急, 2: 高, 3: 中, 4: 低）
• stateId（任意）：状態ID
• assigneeId（任意）：担当者ID
• estimate（任意）：問題の見積もり
• labelIds（任意）：ラベルIDの配列

search-issues

クエリ文字列を使用して線形問題を検索します。様々なフィルターをサポートしています。

• assignee:@me：あなたに割り当てられた問題を表示します。
• priority:[value]：優先度でフィルタリングします。
  • 数値範囲（0 - 4）
  • テキスト値："no", "urgent", "high", "medium", "low"
  • 注意：priority:high には「緊急」と「高」の優先度の問題が含まれます。
• state:[value] または status:[value]：状態名でフィルタリングします。
• team:[value]：チーム名でフィルタリングします。
• label:[value]：ラベル名でフィルタリングします。
• タイトルと説明の自由テキスト検索

read-resource

URIを使用して線形リソースを読み取ります。

• linear://organization - 組織情報
• linear://issues - 問題リスト
• linear://issues/{id} - 特定の問題の詳細
• linear://teams - チームリスト
• linear://teams/{id} - 特定のチームの詳細

🔧 技術詳細

レート制限

サーバーはレート制限を実装しています。

• 1時間あたり1000リクエストの制限
• 自動的なリクエスト追跡
• レスポンスに指標情報が含まれます。

エラー処理

サーバーは詳細なエラーメッセージを提供します。

• 線形APIエラー
• リクエスト超過
• 無効なリソースタイプ
• 認証問題