MCP Server Linearapp

🚀 線形MCPサーバーの使用説明

これは、Linearプラットフォームとやり取りするためのMCP（モジュール化コマンドプロセッサ）サーバーです。コマンドラインまたは統合ツールを通じて、問題の作成、更新、検索、チームやプロジェクトの管理など、さまざまなタスクを実行できます。

🚀 クイックスタート

依存関係のインストール

必要なパッケージをインストールするには、以下のコマンドを実行します。

npm install

APIキーの設定

Linearから提供されたAPIキーを .env ファイルに追加します。

LINEAR_API_KEY=your_api_key_here

サーバーのビルド

サーバーをビルドして使用を開始します。

npm run build

開発時には、以下のコマンドを使用して自動再構築を行うことができます。

npm run watch

💻 使用例

新しい問題の作成

新しい問題を作成するには、linear_create_issue コマンドを使用し、必要なパラメータを指定します。

linear_create_issue --title "新しい認証システムの障害" --description "認証ページでのエラーを報告します。"

既存の問題の更新

既存の問題の属性（優先度や状態など）を更新するには、linear_update_issue を使用します。

linear_update_issue --issue-id FRONT-123 --priority 緊急

コメントの追加

問題にコメントを追加するには、linear_add_comment コマンドを使用し、問題IDとコメント内容を指定します。

linear_add_comment --issue-id LOGIN-456 "根本原因が特定されました：パスワードフィールドが正しく暗号化されていません。"

問題の検索

linear_search_issues コマンドを使用して、条件に合致する問題を検索します。

linear_search_issues --status 進行中 --label フロントエンド

プロジェクト情報の取得

特定のプロジェクトの詳細情報を取得するには、linear_get_project を使用し、プロジェクトIDを指定します。

linear_get_project --project-id MOBILE-APP

チーム管理

チームメンバーのリストを取得

チームのメンバーをリストするには、linear_get_team_members を使用します。

linear_get_team_members --team-id frontend-team

ユーザーが所属するチームを取得

現在のユーザーが所属するすべてのチームを表示するには、linear_get_user_teams を実行します。

linear_get_user_teams

タグ管理

新しいタグの作成

新しい問題タグを作成するには、linear_create_tag コマンドを使用します。

linear_create_tag --name backlog

タグ属性の更新

既存のタグの属性を更新するには、linear_update_tag を使用します。

linear_update_tag --tag-id ui-refactor --color 青

開発説明

依存関係のインストール

必要なパッケージをインストールするには、以下のコマンドを実行します。

npm install

APIキーの設定

Linearから提供されたAPIキーを .env ファイルに追加します。

LINEAR_API_KEY=your_api_key_here

サーバーのビルド

サーバーをビルドして使用を開始します。

npm run build

開発時には、以下のコマンドを使用して自動再構築を行うことができます。

npm run watch

具体的な使用例

問題を作成してコメントを追加

1. linear_create_issue を使用して問題を作成します。

linear_create_issue --title "新しい認証システムの障害" --description "認証ページでのエラーを報告します。"

2. linear_add_comment を使用して、その問題にコメントを追加します。

linear_add_comment --issue-id 新しい認証システムの障害 --comment "根本原因が特定されました：パスワードフィールドが正しく暗号化されていません。"

問題を検索してフィルタリング

特定のタイプの問題を検索し、フィルターを適用するには、以下のコマンドを使用します。

linear_search_issues --status 解決済み --label フロントエンド

📚 ドキュメント

プロジェクト構造

• src/：すべてのソースコードファイルが含まれています。
• commands/：定義されたコマンドモジュールが含まれています。
• config/：設定ファイルと環境変数が含まれています。
• index.js：アプリケーションのエントリポイントです。

よくある質問

APIキーを取得する方法は？

Linearプラットフォームの「ユーザー設定」ページにアクセスし、「開発者ツール」セクションを見つけると、APIキーを取得できます。

サポートされているコマンドは？

現在のバージョンでは、以下のコマンドがサポートされています。

• linear_create_issue
• linear_update_issue
• linear_add_comment
• linear_search_issues
• linear_get_project
• linear_get_team_members

さらなるコマンドが開発中です。

コントリビューションガイド

コミュニティからの貢献を歓迎します！開発に参加する方法については、プロジェクトリポジトリの CONTRIBUTING.md ファイルを参照してください。

📄 ライセンス

このMCPサーバーは、MITライセンスの下で公開されています。これは、MITライセンスの条項と条件に従う限り、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。