Cpropster Linear MCP Server

🚀 線形 MCP サーバー

線形 MCP サーバーは、Linear API とのインタラクションに使用するツールです。チーム、状態、優先度、ラベル、マイルストーン、プロジェクト、サイクルの取得や、問題の作成と更新など、複数の機能モジュールを提供します。

🚀 クイックスタート

依存関係のインストール

npm または yarn を使用してインストールします。

npm install linear-sdk @types/node --save-dev

または

yarn add linear-sdk @types/node -D

プロジェクトの初期化

src/index.ts ファイルを作成し、以下のコードを追加します。

import { Linear } from '@linear/sdk';

const linear = new Linear({
  token: 'your_linear_token',
});

async function main() {
  try {
    const teams = await linear.teams.list();
    console.log('Teams:', teams);
    
    // オプション: 問題の作成など、他の操作を実行する
    const issue = await linear.issues.create({
      teamId: 'team_id', 
      title: 'Test Issue',
      description: 'This is a test issue.',
      assigneeId: 'assignee_id', // オプション
      stateId: 'state_id', // オプション
      priority: 0, // オプション、範囲は 0-4
    });
    console.log('Created Issue:', issue);
  } catch (error) {
    console.error('Error:', error);
  }
}

main();

実行

TypeScript でコンパイルして実行します。

npm run build && npm start

✨ 主な機能

• チームの取得：すべてのチームをリストします。
• 状態の取得：特定のチームのすべての状態をリストします。
• 優先度の取得：特定のチームのすべての優先度をリストします。
• ラベルの取得：特定のチームのすべてのラベルをリストします。
• マイルストーン（時間追跡）の取得：特定のチームのすべてのマイルストーンをリストします。
• プロジェクトの取得：特定のチームのプロジェクトをリストします。チーム ID と返す数を指定することができます。
• サイクルの取得：特定のチームのサイクルをリストします。チーム ID を指定する必要があります。
• 問題の作成：新しい問題を作成します。チーム ID、タイトル、および割り当て先 ID、状態 ID などの他のオプションを指定する必要があります。
• 問題の更新：既存の問題の情報を変更します。問題 ID と他のオプションのパラメータを指定する必要があります。

📦 インストール

依存関係のインストール

npm または yarn を使用してインストールします。

npm install linear-sdk @types/node --save-dev

または

yarn add linear-sdk @types/node -D

💻 使用例

基本的な使用法

// すべてのチームを取得する
const teams = await linear.teams.list();

高度な使用法

// 問題を作成する
const issue = await linear.issues.create({
  teamId: 'team_id',
  title: '新問題',
  description: 'これはテスト用の問題です。',
  assigneeId: 'assignee_id', // オプション
});

📚 ドキュメント

設定ガイド

Linear アプリの作成

1. Linear にログインします。
2. 設定 > アプリに移動し、「新しいアプリを作成」をクリックします。
3. アプリ名と説明を入力し、必要な権限を選択します（最小限の権限を選択することをお勧めします）。

トークンの取得

アプリの詳細ページで、API トークンを見つけてコピーします。このトークンを .env ファイルに追加します。

LINEAR_TOKEN=your_token_here

チュートリアル

• チームリストの取得：teams.list() メソッドを呼び出します。
• 問題の作成：issues.create() メソッドを使用し、必要なパラメータを渡します。

よくある質問

Q: エラーをどのように処理すればよいですか？

A: try-catch 文を使用して例外をキャッチし、コンソールにエラーメッセージを出力します。

try {
  // 操作コード
} catch (error) {
  console.error('エラーが発生しました:', error);
}

Q: 複数のチームをサポートしていますか？

A: はい、teamId パラメータを使用して操作対象の特定のチームを指定できます。

セキュリティに関する注意事項

⚠️ 重要提示

機密情報のコミットを避けるため、.env ファイルをバージョン管理システムに含めないようにしてください。

💡 使用建议

コード内では環境変数を使用してトークンにアクセスしてください。例えば、process.env.LINEAR_TOKEN のようにします。

🤝 貢献ガイド

GitHub リポジトリ linear-mcp に問題やプルリクエストを送信することを歓迎します。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。