Iwark Linear MCP Server

🚀 線形MCPサーバ

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

🚀 クイックスタート

このセクションでは、線形MCPサーバをCursorで使用するための手順を説明します。

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 /absolute/path/to/linear-mcp-server/index.js

3. Cursorでの設定

• Cursorの設定を開く
• 新しいMCPサーバを追加
• タイプを選択：Command
• コマンドを設定：sh /absolute/path/to/linear.sh

これで、Cursorで線形MCPサーバを使用できます。

Linear設定ページ からあなたのLinear 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エラー
• リクエスト過多
• 無効なリソースタイプ
• 認証問題