MCP Linear Server

🚀 線形 MCP 統合サーバー

このサーバーは、モデルコンテキストプロトコル (MCP) を通じて線形統合機能を提供します。AI モデルが Linear と相互作用し、問題追跡やプロジェクト管理を行うことを可能にします。

✨ 主な機能

このサーバーは、MCP インターフェースを通じて以下のツールを提供します。

linear_create_issue

新しい Linear の問題を作成します。以下のパラメータをサポートします。

• title（必須）：問題のタイトル
• teamId（必須）：問題を作成するチームの ID
• description（オプション）：問題の説明
• labels（オプション）：問題のラベルのリスト

linear_list_issues

指定されたチームのすべての問題をリストします。以下のパラメータをサポートします。

• teamId（必須）：対象のチーム ID
• filter（オプション）：フィルタ条件（状態、ラベルなど）

linear_get_issue

単一の問題の詳細情報を取得します。以下のパラメータをサポートします。

• teamId（必須）：対象のチーム ID
• issueId（必須）：取得する問題の ID

linear_update_issue

既存の問題の情報を更新します。以下のパラメータをサポートします。

• teamId（必須）：対象のチーム ID
• issueId（必須）：更新する問題の ID
• title（オプション）：新しいタイトル
• description（オプション）：新しい説明
• labels（オプション）：新しいラベルのリスト

linear_delete_issue

指定された問題を削除します。以下のパラメータをサポートします。

• teamId（必須）：対象のチーム ID
• issueId（必須）：削除する問題の ID

📦 インストール

開発環境のセットアップ

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

   npm install
   

3. .env ファイルを作成し、Linear API キーを追加します。

   LINEAR_API_KEY=your_api_key_here
   

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

   npm run dev
   

🔧 技術詳細

プロジェクトアーキテクチャ

• TypeScript で記述されており、コードの強い型付けと保守性を確保しています。
• Linear SDK をベースに構築され、Linear API のラッパーとサポートを提供します。
• MCP プロトコルと連携して、AI モデルとのシームレスな相互作用を実現します。

核心機能

• 問題の作成、読み取り、更新、削除操作
• チーム間の問題の分離と権限管理
• カスタムフィルターとソートロジックのサポート
• 詳細なエラーハンドリングとログ記録

パフォーマンスと信頼性

キャッシュシステム

• 頻繁にアクセスされる操作を高速化するためにメモリキャッシュを使用します。
• 整合性とパフォーマンスをバランスさせるために適切な有効期限を設定します。
• データの整合性を確保するために手動でキャッシュをリフレッシュできます。

エラーハンドリング

• 包括的なエラー捕捉と処理メカニズム
• 分かりやすいエラーメッセージのフィードバック
• 一時的な障害に対応する自動リトライ戦略

パフォーマンス最適化

• スレッドプールと接続プールの管理
• 並行リクエストの負荷分散
• 効率的なデータアクセスパターン
• 大量のデータセットを処理するためのページングメカニズム

📄 依存関係

• @linear/sdk：Linear API クライアントライブラリ
• @modelcontextprotocol/sdk：MCP サーバーの実装
• zod：ランタイム型チェックと検証
• dotenv：環境変数管理ツール
• TypeScript 開発キットおよび関連ツール

完全な依存関係リストは package.json を参照してください。

🚀 Smithery へのデプロイ

このサーバーは Smithery.ai にデプロイできます。提供される設定ファイルを使用します。

前提条件

• Smithery アカウント
• Linear API キー

デプロイ手順

1. このリポジトリを Smithery に追加するか、既存のサービスをクレームします。
2. デプロイタブにアクセスします（認証された所有者のみ）。
3. デプロイパラメータを設定し、Linear API キーを設定します。
4. サーバーを公開します。

設定ファイル

Dockerfile

サーバーのビルドプロセスを定義します。

• Node.js 18 Alpine をベースイメージとして使用します。
• 依存関係をインストールし、TypeScript コードをビルドします。
• 実行コマンドを設定します。

smithery.yaml

サーバーの起動パラメータを設定します。

• 実行コマンドを指定します。
• 必要な設定パラメータ（Linear API キー）を定義します。
• 環境変数を管理します。

ローカルテスト

1. Docker イメージをビルドします。

   docker build -t linear-mcp-server .
   

2. コンテナを起動し、環境変数を設定します。

   docker run -e LINEAR_API_KEY=your_api_key_here linear-mcp-server
   

3. または、MCP チェックツールを使用します。

   npm run inspect
   

以上で、サーバーを Smithery にデプロイし、ローカルでテストすることができます。