Linear MCP

🚀 Linear MCP サーバー

このサーバーは、Cline を通じて Linear API を管理するための MCP サーバーです。Linear の問題、プロジェクト、チームを管理するための一連のツールを提供します。

🚀 クイックスタート

このサーバーを使用することで、Linear の問題、プロジェクト、チームを効率的に管理できます。以下に、サーバーのインストールと設定方法を説明します。

📦 インストール

1. 環境構築

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

   npm install
   

3. .env.example を .env にコピーします。

   cp .env.example .env
   

2. 認証方法

サーバーは 2 種類の認証方式をサポートしています。

API Key（推奨）

1. Linear の設定にアクセスします。
2. 「セキュリティとアクセス」セクションをクリックします。
3. 「個人用 API キー」セクションを見つけます。
4. 「新しい API キー」をクリックします。
5. キーに説明的なラベル（例：「Cline MCP」）を追加します。
6. 生成されたトークンをコピーします。
7. トークンを .env ファイルに追加します。

   LINEAR_API_KEY=your_api_key
   

OAuth フロー（代替）未実装

1. https://linear.app/settings/api/applications で新しい OAuth アプリを作成します。
2. .env ファイルで OAuth 環境変数を設定します。

   LINEAR_CLIENT_ID=你的_oauth_client_id
   LINEAR_CLIENT_SECRET=你的_oauth_client_secret
   LINEAR_REDIRECT_URI=http://localhost:3000/callback
   

3. サーバーの起動

1. サーバーをビルドします。

   npm run build
   

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

   npm start
   

4. Cline との統合

1. Cline MCP の設定ファイルを開きます。

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Linear MCP サーバーの設定を追加します。

   {
     "mcpServers": {
       "linear": {
         "command": "node",
         "args": ["/path/to/linear-mcp/build/index.js"],
         "env": {
           "LINEAR_API_KEY": "你的个人访问令牌"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

✨ 主な機能

問題管理

• ✅ 完全な情報を持つ問題を作成する
• ✅ 既存の問題の状態、タイトル、説明を更新する
• ✅ 問題を削除する
• ✅ すべての問題のリストを取得する
• ✅ フィルタ条件に基づいて問題を取得する

プロジェクト管理

• ✅ 新しいプロジェクトを作成する
• ✅ 既存のプロジェクトの名前と説明を更新する
• ✅ プロジェクトを削除する
• ✅ すべてのプロジェクトの情報を取得する

チーム管理

• ✅ 新しいチームメンバーを追加する
• ✅ チームメンバーの役割と権限を更新する
• ✅ チームメンバーを削除する
• ✅ すべてのチームメンバーのリストを取得する

開発中の機能

問題コメント

• ✅ 問題コメントを作成する
• ✅ 既存のコメントの内容を更新する
• ✅ コメントを削除する
• ✅ すべてのコメントのリストを取得する

タグ管理

• ✅ 新しいタグを追加する
• ✅ 既存のタグの色と名前を更新する
• ✅ タグを削除する
• ✅ すべてのタグのリストを取得する

💻 使用例

基本的な使用法

開発コマンド

npm install  # 依存関係をインストールする
npm run build  # サーバーをビルドする
npm start  # サーバーを起動する

インターフェース例

問題の作成

POST /api/issues
{
  "title": "新问题",
  "description": "这是一个新的测试问题。",
  "projectId": "12345"
}

問題の状態を更新する

PUT /api/issues/12345
{
  "status": "已完成"
}

すべてのプロジェクトを取得する

GET http://localhost:3000/api/projects

返却結果の例

{
  "data": {
    "projects": [
      {
        "_id": "12345",
        "name": "项目名称",
        "description": "项目描述"
      }
    ]
  }
}

高度な使用法

エラーハンドリング

• 400 Bad Request: リクエスト形式が誤っているか、必須パラメータが欠けています。
• 401 Unauthorized: 認証に失敗しました。
• 404 Not Found: リソースが見つかりません。
• 500 Internal Server Error: サーバー内部エラーです。