Gemini Rust Suite 🦀

Gemini Rust Suite 🦀

このプロジェクトは、Google Gemini モデルと連携するための Rust クレートのスイートを提供し、Model Context Protocol（MCP）を介したツールの使用、永続的なセマンティックメモリ、Linux ターミナル向けの高機能なコマンドラインインターフェース（CLI）などの高度な機能を実現します。

✨ 目次

• アーキテクチャ
• 機能
• 前提条件
• インストール（CLI）
  • 手動インストール
• 設定
  • CLI の設定（config.toml）
  • MCP サーバーの設定（mcp_servers.json）
  • API キーの優先順位
  • システムプロンプトの優先順位
• CLI の使用方法
  • 対話モード
  • チャット履歴
  • メモリ機能
  • MCP 統合と関数呼び出し
• 開発

🏗️ アーキテクチャ

Gemini Rust Suite は、Cargo ワークスペース内の複数のクレートで構成されるモジュール型プロジェクトです。

• gemini-core：基盤となるコンポーネントを提供します。

  • Google Gemini API（generateContent エンドポイント）とやり取りするための、非同期の GeminiClient。
  • Gemini API のリクエスト／レスポンス形式（コンテンツパート、関数呼び出し、生成設定）を反映した、型安全な Rust 構造体。
  • コア設定の読み込み（TOML からの GeminiConfig）とエラー処理（GeminiError）。
  • MCP で使用される共有 JSON-RPC 型（Request、Response、ServerCapabilities、Tool）。

• gemini-ipc：プロセス間通信の定義を一元管理します。

  • 異なるデーモン／クライアント（例：gemini-cli、mcp-hostd、HAPPE、IDA）間でやり取りされるメッセージ用の、標準化された Rust 構造体／列挙型を定義します。
  • 通信プロトコルの一貫性を確保します（シリアライズには serde を使用します）。

• gemini-mcp：Model Context Protocol（MCP）のホスト側を実装します。

  • McpHost は、MCP サーバー（外部のツール／サービス）の検出、起動（stdio、SSE、WebSocket 経由）、通信を管理します。
  • ツールの実行（mcp/tool/execute）およびリソースの取得に関する JSON-RPC 通信を処理します。
  • Gemini の関数呼び出しと MCP ツールの実行を相互に変換します。
  • mcp-hostd バイナリ（gemini-ipc を使ってクライアントと通信する、スタンドアロンの MCP ホストデーモン）を含みます。
  • 組み込み MCP サーバー（filesystem、command、memory_store）のソースを提供します。

• gemini-memory：永続的なセマンティックメモリストアを実装します。

  • ベクトルデータベースとして LanceDB を使用します。
  • メモリ（メタデータ付きのキーと値のペア）と、そのベクトル埋め込みを保存します。
  • クエリの意味に基づいて関連するメモリを見つけるため、セマンティック検索を実行します。
  • ベクトル生成用の外部 embedding/embed ツールを呼び出すために、McpHostInterface（通常は gemini-mcp が提供）を使用します。
  • LLM のプロンプトに関連するメモリのコンテキストを追加する enhance_prompt 機能を提供します。

• gemini-cli：ユーザー向けの主要アプリケーションです。

  • 他のクレートを使用して構築されたコマンドラインインターフェイス（gemini-cli-bin）。
  • 単発のプロンプト、対話型チャット、タスクループをサポートします。
  • ツールの使用には MCP を、コンテキスト認識と履歴には Memory を統合します。
  • ユーザー設定、チャット履歴、セッション状態を管理します。
  • mcp-hostd デーモンに接続する（gemini-ipc 経由）か、組み込みの McpHost を実行できます。
  • フラグ（--filesystem-mcp など）を使って、組み込み MCP サーバーを直接実行することもできます。

• （新規）HAPPE：ホストアプリケーション環境デーモンです。

  • より複雑なシナリオにおいて、CLI の直接使用に代わる主要な実行環境となることを目的としています。
  • ユーザー／クライアント、メインの LLM、IDA、MCP サーバー間のやり取りを管理します。
  • gemini-ipc を使用して IDA と通信します。
  • LLM 呼び出しと、LLM が開始する MCP ツールの実行を処理します。

• （新規）IDA：内部対話アプリケーションデーモンです。

  • 永続的なメモリやその他のバックグラウンド認知タスクを管理します。
  • gemini-ipc を介して HAPPE と通信します。
  • 取得と保存のため、Memory MCP Server と（gemini-mcp のクライアントロジックを介して）やり取りします。

🚀 機能

このスイートは、各コンポーネントを通じて包括的な機能を提供します。

• コア API へのアクセス：Gemini API と堅牢な非同期通信を行います。
• ツールの使用（MCP）：Model Context Protocol を介して外部のツールやサービスに接続し、Gemini の機能を拡張します。
• 永続メモリ：セマンティックベクトルデータベース（LanceDB）を使用して Gemini に長期記憶を持たせ、セッションをまたいだコンテキストの取得を可能にします。
• プロンプトの自動拡張：関連するメモリをプロンプトに自動的に挿入します。
• メモリの自動保存：会話から重要な情報を自動的に取得し、メモリストアに保存します。
• 対話型 CLI：複数の対話モードを備えた、使いやすいコマンドラインインターフェース（gemini）です。
• チャット履歴：CLI コマンド間で会話履歴を保持します（シェルのラッパー関数が必要です）。
• 設定：設定ファイルと環境変数を使用して、API キー、システムプロンプト、モデル、機能フラグを管理します。
• 整形された出力：CLI は Markdown と構文強調表示をレンダリングします。
• 組み込みツール：ファイルシステム操作、コマンド実行、メモリの保存・埋め込みに対応した、すぐに使える MCP サーバーが含まれています。

✅ 前提条件

• Rust ツールチェーン： https://rustup.rs/ からインストールしてください 🛠️
• Gemini API キー： Google AI Studio から取得してください 🔑
• 対応シェル（CLI ラッパー用）： シームレスな gemini コマンドの利用には、Bash または Zsh を推奨します 🐚
• （任意）外部 MCP サーバー： 組み込みツール以外のツールに接続する場合に必要です。

📦 インストール（CLI）

このスイートを利用する主な方法は、gemini-cli アプリケーションを使用することです。最も簡単なインストール方法は、付属のスクリプトを使用することです。

# Clone the repository (if you haven't already)
# git clone https://github.com/your-username/gemini-rust-suite
# cd gemini-rust-suite

# Run the installation script from the project root
./install.sh

スクリプトは次の処理を行います。

1. Rust がインストールされているか確認します。
2. インストール先ディレクトリ（~/.local/bin）が存在するか確認し、必要に応じて作成します。
3. リリース用バイナリ（gemini-cli-bin と mcp-hostd）をビルドします。
4. バイナリを ~/.local/bin/ にインストールします。
5. install_mcp_servers.sh が見つかった場合は、そのスクリプトを使用して MCP サーバーのラッパースクリプト（組み込みサーバー用など）のインストールを試みます。
6. ~/.bashrc または ~/.zshrc（検出された場合）に、gemini という名前のラッパー関数を追加します。 このラッパーは、別々のコマンド間でセッション履歴を管理するために不可欠です。
7. （Zsh のみ） mcp-hostd デーモンを管理するためのヘルパー関数 mcpd を追加します（mcpd start、mcpd stop、mcpd status、mcpd logs）。
8. シェル設定の再読み込みを促します（例：source ~/.zshrc）。

重要： インストール後、シェル設定を再読み込みして、gemini コマンド（Zsh ユーザーの場合は mcpd も）を使用できるようにする必要があります。🔄

手動インストール（Bash／Zsh を使用しない場合、または手動で設定する場合）🔧

1. 必要なバイナリをビルドします。

   cargo build --release --bin gemini-cli-bin --bin mcp-hostd
   

2. バイナリを PATH 上の場所にコピーします。

   cp target/release/gemini-cli-bin ~/.local/bin/
   cp target/release/mcp-hostd ~/.local/bin/
   

3. 選択した場所（例：~/.local/bin）が PATH に含まれていることを確認します。
4. 重要： コマンド間でセッション履歴を有効にするには、install.sh スクリプト内または以下のセクションにある gemini ラッパー関数を、シェル設定ファイル（.bashrc、.zshrc など）に手動で追加してください。ラッパーがない場合、履歴が保持されるのは単一の対話型（-i）セッション内だけです。

   # Gemini CLI Wrapper Function Start
   # This function wraps the gemini-cli-bin to manage session environment variables
   gemini() {
       # Path to the actual binary
       local gemini_bin="$HOME/.local/bin/gemini-cli-bin"
       
       # Check if binary exists
       if [ ! -x "$gemini_bin" ]; then
           echo "Error: gemini-cli-bin not found or not executable at $gemini_bin" >&2
           return 1
       fi
   
       # Run the actual binary, capturing output
       local output
       # Use eval to handle potential quotes in arguments correctly
       output=$(eval "$gemini_bin \"\$@\"") 
       local exit_code=$?
   
       # Extract export commands from the output if the command was successful
       if [ $exit_code -eq 0 ]; then
           # Filter lines starting with # export
           local exports
           exports=$(echo "$output" | grep '^# export')
   
           # Execute the export commands if any were found
           if [ -n "$exports" ]; then
               # Remove the comment and execute
               eval "$(echo "$exports" | sed 's/^# export //')"
           fi
           
           # Print the output, excluding the export lines
           echo "$output" | grep -v '^# export'
       else
           # If the command failed, just print the output (likely error messages)
           echo "$output"
       fi
   
       return $exit_code
   }
   # Gemini CLI Wrapper Function End
   

5. シェル設定を再読み込みします。

⚙️ 設定

このスイートでは、主に CLI で管理する複数の設定ファイルを使用します。

CLI 設定（config.toml）

• 場所： ~/.config/gemini-suite/config.toml
• 目的： CLI とデーモン（HAPPE、IDA、mcp-hostd）の統合設定です。
• 管理方法： gemini config または gemini daemon-manager config サブコマンドを使用します。
• 詳細： cli/README.md と daemon-manager/README.md を参照してください。

MCP サーバー設定（mcp_servers.json）

• 場所： ~/.config/gemini-suite/mcp_servers.json
• 目的： MCP Host が外部ツールサーバーに接続する方法を定義します。
• 管理方法： gemini mcp または gemini daemon-manager mcp サブコマンドを使用します。

API キーの優先順位 🔑

1. ~/.config/gemini-suite/config.toml の値。
2. GEMINI_API_KEY 環境変数。
3. カレントディレクトリ（開発中はプロジェクトルート）の .env ファイルの値。

システムプロンプトの優先順位 🗣️

1. ~/.config/gemini-suite/config.toml の値。
2. CLI に組み込まれたデフォルトのプロンプト。

💡 CLI の使用方法

インストールしてシェルを再読み込みした後、ラッパーコマンド gemini を使用します。

# Basic prompt
gemini "Explain Rust's ownership model."

# Interactive chat mode (maintains history within the session)
gemini -i
# Type '/exit' or press Ctrl+C to quit

# Using the wrapper for history across commands:
# First command (creates a session ID):
gemini "What is the capital of France?"
# Subsequent command uses the history (if shell reloaded/wrapper sourced):
gemini "What language do they speak there?"

# Start a new conversation thread (gets a new session ID)
gemini --new-chat "Tell me about Tokio."

# Ask Gemini for command help (requires 'command' MCP server)
gemini -c "list files sorted by modification time"

# Ask Gemini to use a tool (requires relevant MCP server)
gemini "Read the contents of my main.rs file."

# Task loop mode
gemini -t "Refactor the Rust code in src/utils.rs to improve error handling."

# Show configuration
gemini --show-config

# Get help on all flags
gemini --help

# Manage the MCP Host Daemon (Zsh only, via install.sh helper function)
mcpd start
mcpd status
mcpd stop
mcpd logs

対話モード

• 単発（デフォルト）： プロンプトを 1 つ送信し、回答を 1 つ受け取ります。
• 対話型チャット（-i）： 1 回の CLI 実行中に REPL 形式で会話します。このモード中は履歴が保持されます。
• タスクループ（-t）： Gemini に複雑なタスクを割り当てて自律的に作業させます。ツールを使用することもあり、必要な場合にのみ確認を求めます。

チャット履歴

• 履歴は ~/.local/share/gemini-suite/history/ 内のファイルに保存されます。
• シェルセッションをまたいで正しく動作させるには、インストーラーによってインストールされるラッパー関数が必要です。

メモリ機能

gemini-memory と LanceDB（~/.local/share/gemini-suite/memory.db）によって機能します。

• メモリブローカー（--enable-memory-broker / --disable-memory-broker）： 関連する過去のメモリを自動的に取得し、プロンプトのコンテキストとして追加します。
• 自動メモリ（--enable-auto-memory / --disable-auto-memory）： 会話から重要な情報を自動的に抽出して保存します。
• 埋め込みサービスが必要です。通常は組み込みの memory-store-mcp サーバー、または mcp_servers.json で設定した外部の同等サービスが提供します。

MCP 統合と関数呼び出し

gemini-mcp によって機能します。

• CLI は、mcp_servers.json で定義された MCP サーバーに接続します（mcp-hostd デーモン経由、または内部ホスト経由）。
• 検出されたツールが Gemini に提示されます。
• Gemini がツールの使用を決定すると、次のようになります。
  1. CLI にツール呼び出し案が表示されます（例：filesystem.readFile(path="./README.md")）。
  2. 実行前に 確認（y/n）を求められます。
  3. 確認すると、MCP ホスト／サーバー経由でツールが実行されます。
  4. 結果が Gemini に返されます。
• セキュリティ： ツール呼び出しを確認する前に、必ず内容を確認してください。特に command の実行やファイルシステムの変更には注意してください。
• 組み込みサーバー： CLI のバイナリ自体で、次の同梱サーバーを実行できます。
  • gemini --filesystem-mcp
  • gemini --command-mcp
  • gemini --memory-store-mcp（メモリ機能向けに埋め込みとストレージを提供します） （これらのフラグはサーバーのみを実行し、プロンプトは受け付けません。）
• デーモンの管理： mcp-hostd バイナリはスタンドアロンのデーモンです。直接管理する（例：mcp-hostd &）か、Zsh ユーザー向けに install.sh が追加するヘルパー関数 mcpd を使用できます（mcpd start、mcpd stop、mcpd status、mcpd logs）。

💻 開発

このプロジェクトは Cargo ワークスペースです。

# Clone the repository
# git clone https://github.com/your-username/gemini-rust-suite
# cd gemini-rust-suite

# Build all crates
cargo build

# Build the CLI specifically (release mode)
cargo build --release --package gemini-cli

# Run the CLI directly from the workspace root
# (Ensure API key is set via .env in workspace root or exported env var)
cargo run --package gemini-cli -- "Your prompt"

cargo run --package gemini-cli -- -i # Interactive mode

cargo run --package gemini-cli -- -c "find text in files" # Command help

# Run tests for all crates
cargo test

# Run tests for a specific crate
cargo test --package gemini-core

# Run the MCP Host Daemon directly
cargo run --package gemini-mcp --bin mcp-hostd