Gemini With Web Search

🚀 MCP 双子星協議サーバー（MCP Gemini）使用説明

MCP 双子星協議サーバーは、Gemini AI サービスを提供するための Node.js ベースのミドルウェアです。標準の JSON - RPC プロトコルインターフェースを通じて、テキスト生成、画像処理、ビデオ分析、ウェブ検索などの機能を提供します。

📄 ライセンス

MIT ライセンス

Copyright (c) 2024 星辰科技公司
本プロジェクトは MIT ライセンスに準拠しています。

📋 使用条件

• 非商用目的のみに使用可能で、許可なく営利目的に使用してはなりません。
• 修正版には修正声明を記載する必要があります。
• 原文のリンクは常に表示されている必要があります。

📈 バージョン履歴

v1.0.0 (2024-03-15)

• 初期バージョンのリリース
• 基本機能の提供：テキスト生成、画像処理、ビデオ分析

v2.0.0 (2024-05-20)

• Gemini 2.0 モデルの導入
• 新しい Web 検索機能の追加
• API インターフェースの最適化

✨ 主な機能

テキスト生成機能

• マルチターンダイアログのサポート
• コンテキストメモリの提供
• 多言語サポート

画像編集機能

• Gemini 2.0 モデルに基づく
• 画像生成と編集のサポート
• さまざまなビジュアルエフェクトの提供

ビデオ分析機能

• YouTube ネットワークビデオの解析
• コンテンツの自動要約抽出
• キーフレームの識別と定位

ウェブ検索

• リアルタイムのネットワーク情報検索
• スマートな結果フィルタリング
• 多言語検索のサポート

📦 インストール

環境要件

• Node.js バージョン 18.0.0 以上
• npm または yarn パッケージ管理ツール
• パブリッククラウドサービスアカウント（オプション）

インストール手順

# コードリポジトリをクローンする
git clone https://github.com/techkwon/mcp-gemini.git

# プロジェクトディレクトリに移動する
cd mcp-gemini

# 依存パッケージをインストールする
npm install

# 環境変数を設定する
export GOOGLE_API_KEY=your_api_key_here

# サービスを起動する
npm run start

機能設定

API インターフェース設定

• デフォルトのリッスンアドレス：localhost
• リッスンポート：8000
• CORS ホワイトリスト：設定可能で、複数のドメインをサポート

ログ管理

• pino を使用して構造化ログを記録する
• 開発環境では pino - pretty モジュールをサポートし、より使いやすいログ表示を提供する

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

1. API キーは環境変数を通じて渡す必要があります。
2. 本番環境では HTTPS を有効にすることをおすすめします。
3. コード内に直接キー情報を埋め込むことを禁止します。
4. アクセスレート制限を設定することをおすすめします。
5. セキュリティ証明書を定期的に更新してください。

🛠️ トラブルシューティング

ポート競合問題

8000 ポートが使用中の場合は、以下のコマンドを実行します。

# 関連するプロセスを検索して終了する
sudo lsof -i :8000

# または pstree コマンドを使用して具体的なプロセスを確認する
pstree -p | grep node

サービスの安定性維持

• PM2 などの専用ツールを使用してプロセス管理を行うことをおすすめします。
• システムログを定期的に確認し、サーバーの稼働状態を分析してください。
• メモリリークやパフォーマンス低下の問題をすぐに解決してください。

🛠️ 開発ガイド

ログシステム

• pino を使用して構造化ログを記録する
• 複数のログ出力形式をサポートし、デフォルトは JSON 形式

設定管理

• 環境変数の優先順位は設定ファイルより高い
• デフォルトの設定テンプレートを提供し、必要に応じてカスタマイズ可能

👨‍💻 プロジェクトメンテナ

• 張三（責任者）
• 李四（技術顧問）

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

コミュニティからの貢献を歓迎します！コード開発と提出の方法を理解するために、貢献規範ドキュメントを読んでから始めてください。

📄 オープンソースライセンス

本プロジェクトは MIT オープンソースライセンスに準拠しており、すべての貢献は MIT ライセンスの下で管理されます。