Linear MCP Server

🚀 Linear MCP サーバー

このサーバーは、TypeScript と Model Context Protocol（MCP）プロトコルに基づいて実装された、カスタムの線形 (Linear) 問題追跡システムアダプターです。AI エージェントが標準入出力を通じて Linear プラットフォームとやり取りできるようにし、問題、チーム、プロジェクトの作成、照会、更新などの操作をサポートします。

🚀 クイックスタート

1. API キーの取得

Linear ウェブサイトにアクセスし、新しいプロジェクトを作成して API インターフェースキーを取得します。

2. 依存関係のインストール

Node.js パッケージマネージャーを使用して必要な依存関係をインストールします。

npm install @linear/sdk@37.0.0 @modelcontextprotocol/sdk@0.6.0

3. サーバーの起動

プロジェクトのルートディレクトリに index.ts ファイルを作成し、以下のコードを追加して実行します。

import { LinearMCPAdapter } from './src/adapter';

const adapter = new LinearMCPAdapter({
  token: 'your-linear-token',
  projectId: 'your-project-id'
});

adapter.start();

次に、以下のコマンドを実行します。

npm run dev

✨ 主な機能

問題管理

• 問題の作成：/create-issue エンドポイントに POST リクエストを送信することで、タイトル、説明、優先度、担当者をカスタマイズできます。
• 問題の照会：プロジェクト ID、チーム ID、状態パラメータを使用して問題を柔軟にフィルタリングでき、デフォルトでは最初の 50 件のレコードが返されます。
• 問題の更新：既存の問題のすべてのフィールド（タイトル、説明、状態、担当者など）を更新できます。

チーム管理

• すべてのチームの取得：/list-teams エンドポイントを呼び出すと、現在のワークスペース内のすべてのチーム情報が返されます。

プロジェクト管理

• すべてのプロジェクトの取得：チーム ID でフィルタリングしてプロジェクトリストを照会でき、デフォルトでは最初の 50 個のプロジェクトが返されます。

📚 ドキュメント

迅速な開発

プロジェクトのルートディレクトリで以下のコマンドを実行して、開発サーバーを起動し、自動ビルド機能を有効にします。

npm run dev

自動再構築

以下のコマンドを使用して、開発環境のホットリロードを維持します。

npm run watch

デバッグツール

以下のコマンドを実行してデバッグツールをインストールし、デバッグサーバーを起動します。

npm install -g supergiant
supergiant start

🔧 技術詳細

• ビルドツール：TypeScript と Node.js を使用して開発されています。
• 依存関係管理：
  • Linear SDK バージョン：37.0.0
  • MCP SDK バージョン：0.6.0
• 通信プロトコル：標準入出力に基づくカスタムプロトコルで、Model Context Protocol 標準と互換性があります。

💻 使用例

基本的な使用法

問題の作成例

ターミナルで以下のコマンドを実行して新しい問題を作成します。

echo '{
  "title": "测试问题标题",
  "description": "这是一个测试问题，用于验证API功能。",
  "priority": 2,
  "labels": ["bug", "high"]
}' | ./dist/index.js

問題の照会例

指定されたチームの問題リストを照会します。

echo '{
  "assignee": "user123",
  "status": "open"
}' | ./dist/index.js

🔧 エラー処理

すべての API リクエストは、以下の形式の構造化されたエラー情報を返します。

{
  "error": {
    "code": string; // エラーコード
    "message": string; // エラー説明
  }
}

📄 コード構造の全体像

// src/adapter.ts
export class LinearMCPAdapter {
  private token: string;
  private projectId: string;

  constructor(options: {
    token: string;
    projectId: string;
  }) {
    this.token = options.token;
    this.projectId = options.projectId;
  }

  public async createIssue(issue: CreateIssueParams): Promise<void> {
    // 問題作成の具体的なロジックを実装
  }

  public async getIssues(filter?: GetIssuesFilter): Promise<Issue[]> {
    // 問題リストの取得ロジックを実装
  }

  public async updateIssue(id: string, updates: UpdateIssueParams): Promise<void> {
    // 問題更新のロジックを実装
  }

  public async getIssue(id: string): Promise<Issue | null> {
    // 単一の問題の詳細を取得するロジックを実装
  }
}

⚠️ その他の注意事項

• すべての API リクエストは JSON 形式のリクエストボディをサポートしています。
• 本番環境では HTTPS プロトコルを使用して通信することを確認してください。
• 機密操作では適切なエラー処理メカニズムを追加することをお勧めします。

👥 プロジェクトへの貢献

このアダプターの機能を共同で改善するために、fork して Pull Request を送信することを歓迎します。