Gemini MCP Server

Gemini MCP サーバー

このプロジェクトは、AI アシスタントやその他の MCP 対応クライアントとの連携を可能にする、Google Search 用の Model Context Protocol（MCP）サーバーを実装しています。

---

前提条件

• Node.js 18+
• npm

---

インストール

1. リポジトリをクローンする

git clone https://github.com/your-username/mcp-google-search.git
cd google-mcp-server

2. 依存関係をインストールする

npm install

3. Google Custom Search API の認証情報を設定する

プロジェクトのルートに .env ファイルを作成し、次の内容を記述します。

GEMINI_API_KEY=your_google_api_key_here

• GOOGLE_API_KEY：Google Custom Search API キーです。

認証情報は、Google Custom Search JSON API のドキュメントから取得できます。

---

使用方法

1. テスト検索を実行する

npx ts-node src/test.ts

サンプル検索を実行し、結果をコンソールに出力します。

2. MCP 対応クライアントと連携する

このサーバーを MCP 設定の一部として使用するには、MCP 設定ファイル（例：claude_desktop_config.json）にエントリを追加します。

{
  "mcpServers": {
    "gemini-api": {
      "command": "npx",
      "args": ["ts-node", "src/index.ts"],
      "env": {
        "GEMIN_API_KEY": "your_gemini_api_key_here",
      }
    }
  }
}

API キーと CX ID を実際の認証情報に置き換えてください。

---

利用可能なツール

このサーバーでは、次のツールを提供しています。

1. googleSearchContent：Google Custom Search API を使用してウェブ検索を実行し、構造化された結果（タイトル、リンク、スニペット）を返します。
2. googleSearchImages：Google Custom Search API を使用して画像検索を実行し、最初の検索結果への Markdown 画像リンクを返します。

詳しい使用方法については、src/tools.ts のソースコードを参照してください。

---

開発

プロジェクトを変更するには、次の手順に従います。

1. 必要に応じて src ディレクトリ内のコードを変更します。
2. 依存関係を追加または削除した場合は、package.json を適宜更新します。
3. 変更を反映するには、MCP クライアントまたはテストスクリプトを再起動します。

---

トラブルシューティング

• Google API キーと CX ID が .env ファイルまたは環境に正しく設定されていることを確認してください。
• すべての依存関係がインストールされていることを確認してください（npm install）。
• Node.js 18 以降を使用していることを確認してください。
• コードを変更した場合は、サーバーまたはテストスクリプトを再起動してください。

---

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。