Linear MCP Server

🚀 Linear MCP サーバー

Linear MCP サーバーは、Linear と MCP プロトコルを統合したサーバーです。TypeScript を使用した型安全な開発や、Bun ランタイムによる高い実行効率を提供します。

🚀 クイックスタート

本サーバーを使用するには、まず必要な依存関係をインストールし、サーバーを起動するための環境変数を設定する必要があります。

✨ 主な機能

• 型安全：すべてのインターフェースとメソッドが TypeScript で定義されており、コードの型安全性を保証します。
• 高い実行効率：Bun ランタイム環境に基づいて構築されており、卓越した実行効率を提供します。
• 統合開発ツールキット：Linear の公式 SDK と MCP プロトコル 1.4.0 バージョンが統合されています。

📦 インストール

依存関係のインストール

このプロジェクトを使用するには、以下の依存関係をインストールしてください。

bun add @linear/sdk @modelcontextprotocol/sdk

サーバーの起動

サーバーを起動する前に、環境変数 NEXT_PUBLIC_LINEAR_SDK_CONFIG を設定します。

{
  "url": "https://app.linear.app",
  "authType": "token"
}

その後、以下のコマンドを実行します。

bun dev

📚 ドキュメント

構成パラメータ

環境変数

• NEXT_PUBLIC_BASE_URL：あなたの Linear ベース URL に設定します。デフォルトは https://app.linear.app です。
• NEXT_PUBLIC_WEB_BASE_URL：あなたの Web アプリケーションの公開 URL に設定します。

その他の設定

.env ファイルに以下の内容を追加します。

NEXT_PUBLIC_LINEAR_SDK_CONFIG=url=https://app.linear.app&authType=token

💻 使用例

基本的な使用法

import { type Context } from '@modelcontextprotocol/sdk'

export async function getContext(): Promise<Context> {
  const config = new Configuration()
  const client = new LinearClient(config)
  return await client.getContext()
}

高度な使用法

チーム管理

• すべてのチームを取得する：GET /api/teams
• 特定のチームを検索する：名前またはキーでのフィルタリングをサポートします。

プロジェクト操作

• すべてのプロジェクトをリストする：GET /api/projects
• 新しいプロジェクトを作成する：POST /api/projects

🔧 技術詳細

アーキテクチャコンポーネント

• フロントエンド：React と Tailwind CSS を使用してレスポンシブなデザインを実現しています。
• バックエンド：Bun をベースにした効率的なサーバーアーキテクチャを構築しています。

データ処理フロー

1. リクエストの受信と解析
2. パラメータの検証
3. ビジネスロジックの実行
4. 結果の包装と返却

エラー処理メカニズム

例外捕捉

• ネットワークエラーの検出
• HTTP ステータスコードの処理
• 詳細なエラーログの記録

グローバルミドルウェア

すべての API リクエストとレスポンスを統一的に処理し、システムの安定性を確保します。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しています。詳細については、LICENSE ファイルを参照してください。