🚀 Linear-MCP-for-Gemini_CLI

License: ISC Node.js Version Model Context Protocol

Gemini CLIをLinearワークスペースに直接接続するために構築された、強力なオープンソースの**Model Context Protocol (MCP)**サーバーです。ターミナルから自然言語を使用して、課題、チーム、ワークフローをシームレスに管理できます。

🌟 特徴

🔍 検索と発見: Gemini CLIから直接、ワークスペース全体の課題を検索できます。
📝 課題管理: 課題の取得、作成、更新（ステータス、優先度、担当者など）を簡単に行えます。
💬 コラボレーション: ターミナルを離れることなく、課題にコメントを追加できます。
🏢 ワークスペースの洞察: チーム、ユーザー、ワークフローの状態を一覧表示し、Geminiに完全なコンテキストを提供します。
⚡ リアルタイム統合: 低遅延で安全な通信を実現するModel Context Protocolに基づいて構築されています。

📋 前提条件

開始する前に、以下がインストールされていることを確認してください：

Node.js: バージョン18.0.0以上。
Gemini CLI: マシンにインストールおよび設定済みであること。
Linearアカウント: APIキーを生成する権限があること。

📖 Gemini CLI統合ガイド（完全版）

このサーバーはTypeScriptで記述されています。Gemini CLIがMCPサーバーを実行するには標準のJavaScript実行ファイルが必要なため、最初にプロジェクトをダウンロードして「ビルド」する必要があります。

以下の4つのステップに従って接続を完了させてください。

ステップ1: サーバーのダウンロードとビルド

リポジトリをマシンにクローンします:

git clone https://github.com/tenx-studio/Linear-MCP.git
cd linear-mcp-open-source

必要なパッケージをインストールします:
```
npm install
```
コードをコンパイルします:
```
npm run build
```
（なぜこれを行うのか？このコマンドはTypeScriptコードをdist/index.jsファイルに変換します。これがGemini CLIがLinearと通信するために使用するファイルです。）

ステップ2: Linear APIキーの取得

Linearワークスペースの Settings > API > Personal API keys に移動します。
New API key をクリックし、わかりやすい名前（例: "Gemini CLI"）を付けます。
キーをコピーします（最後のステップで必要になります）。

ステップ3: Gemini CLIへの接続（必要な唯一の設定）

次に、ビルドしたサーバーの場所をGemini CLIに伝え、APIキーを安全に提供します。これを行うには、Gemini CLIの設定ファイルを編集します。

設定ファイルの場所: ファイルエクスプローラーまたはターミナルを開き、ユーザーのホームディレクトリにある.geminiフォルダーを探します：
- Windows: %USERPROFILE%\.gemini\settings.json （例: C:\Users\YourName\.gemini\settings.json）
- Mac/Linux: ~/.gemini/settings.json （注: .geminiフォルダーやsettings.jsonファイルがまだ存在しない場合は、作成してください。）
設定の追加: settings.jsonを任意のテキストエディター（VS Code、Notepad、TextEditなど）で開き、以下のmcpブロックを貼り付けます。ファイルに既に内容がある場合は、メインの{}括弧内に"mcp"セクションを追加してください：

{
  "mcp": {
    "servers": {
      "linear": {
        "command": "node",
        "args": ["/ABSOLUTE/PATH/TO/linear-mcp-open-source/dist/index.js"],
        "env": {
          "LINEAR_API_KEY": "lin_api_your_key_here"
        }
      }
    }
  }
}

⚠️ 重要な調整:

args: /ABSOLUTE/PATH/TO/... を、このリポジトリをクローンしたコンピューター上の実際のフルパスに置き換える必要があります。（例: "D:/Projects/linear-mcp-open-source/dist/index.js"）
LINEAR_API_KEY: lin_api_your_key_here を、ステップ2でコピーした実際のAPIキーに置き換えてください。

ステップ4: チャットを開始！

ターミナルを閉じて再度開き、Gemini CLIセッションを再起動します。これで統合が有効になります！

Gemini CLIに次のように話しかけてみてください：

"List my Linear teams." （Linearのチームをリストアップして） "Find the issue about the login bug." （ログインバグに関する課題を見つけて） "Create a new high priority issue in the Engineering team to update the README." （READMEを更新するために、Engineeringチームに優先度高の新しい課題を作成して）

🤖 自動接続の仕組み

「これを使うたびにnpm startを実行する必要があるのか？手動でサーバー接続を設定する必要があるのか？」 と思われるかもしれません。

いいえ！追加で行うことは何もありません。

ステップ3で設定ブロックを追加することが、必要な唯一のセットアップです。内部では正確に以下のことが行われます：

ゼロタッチ起動: settings.jsonに設定を追加したため、Gemini CLIがネイティブにホストとして機能します。
バックグラウンド実行: 新しいGemini CLIチャットを開始するたびに、このLinear MCPサーバーが隠れたバックグラウンドプロセスとして自動的に起動します。
安全なハンドシェイク: Gemini CLIは設定から"LINEAR_API_KEY"を読み取り、サーバーに直接安全に注入します。
クリーンな終了: Gemini CLIを閉じると、バックグラウンドサーバーは自動的に終了します。

設定で一度構成するだけで、Model Context Protocolがライフサイクル全体を自動的に処理します！

🤝 コントリビューション

オープンソースコミュニティは、学び、刺激を受け、創造するための素晴らしい場所です。皆様からのコントリビューションは非常に歓迎されます。

プロジェクトをフォークする
フィーチャーブランチを作成する (git checkout -b feature/AmazingFeature)
変更をコミットする (git commit -m 'Add some AmazingFeature')
ブランチにプッシュする (git push origin feature/AmazingFeature)
プルリクエストを開く

📄 ライセンス

このプロジェクトは ISCライセンス の下でライセンスされています。

AI開発者コミュニティのために愛を込めて作成されました。

Linear MCP Server