MCP Gemini Tutorial

🚀 双子星を使用したモデルコンテキストプロトコル（MCP）構築チュートリアル

このリポジトリには、Googleの双子星2.0モデルを使用してモデルコンテキストプロトコル（MCP）サーバーを構築する完全なコードが含まれています。具体的な実装については、この記事を参照してください。

📚 モデルコンテキストプロトコル（MCP）とは？

MCPは、Anthropicによって開発されたオープン標準で、AIモデルが外部のツールやリソースにシームレスにアクセスできるようにします。これは、AIモデルとツール間の相互作用に標準化された方法を提供し、各ツールやモデルに対してカスタム統合を行う必要がありません。

主な利点は以下の通りです：

• 相互運用性：互換性のあるMCPモデルは、互換性のある任意のツールを使用できます。
• モジュール性：モデルの統合を変更することなく、ツールを簡単に追加または更新できます。
• 標準化：一貫したインターフェースにより、統合の複雑さが軽減されます。
• 役割の分離：モデル機能とツール機能が明確に分離されています。

📋 プロジェクトの概要

このチュートリアルでは、以下のことを行う方法を示します：

• Brave Searchを統合した完全なMCPサーバーを構築する。
• それをGoogleの双子星2.0モデルに接続する。
• AI駆動のアプリケーション用の柔軟なアーキテクチャを作成する。

🚀 クイックスタート

📋 前提条件

• Bun（TypeScriptを高速で実行するため）
• Brave Search APIキー
• 双子星モデルにアクセスするためのGoogle APIキー

📦 インストール

# リポジトリをクローンする
git clone https://github.com/GuiBibeau/mcp-gemini-tutorial.git
cd mcp-tutorial

# 依存関係をインストールする
bun インストール

⚙️ 環境設定

.envファイルを作成し、APIキーを追加します：

BRAVE_API_KEY="your_brave_api_key"
GOOGLE_API_KEY="your_google_api_key"

💻 使用例

基本的な使用法

bun examples/basic-client.ts

高度な使用法

bun examples/gemini-tool-function.ts

📁 プロジェクト構造

• src/ - MCPサーバーの核心実装とツール
• examples/ - MCPサーバーの使用方法を示すサンプルクライアント
• tests/ - プロジェクトのテストファイル

🛠️ 実装されたツール

このMCPサーバーでは、主に2つのツールが実装されています：

1. Web検索：Brave Searchを使用した一般的なインターネット検索
2. ローカル検索：Brave Searchを使用した企業や場所の検索

🔍 プロジェクトの拡張

以下の手順で、独自のツールを追加できます：

1. 新しいツールを定義し、そのスキームを提供する。
2. そのツールの機能を実装する。
3. それをMCPサーバーに登録する。

📖 詳細情報

• 公式MCPドキュメント
• Google双子星APIドキュメント
• Brave Search APIドキュメント

📄 ライセンス

MIT

このプロジェクトはbun initを使用して作成され、bun v1.1.37です。Bunは高速なワンストップJavaScriptランタイムです。