🚀 Build Custom MCP Servers 📝☀️📰

🚀 カスタム MCP サーバーを構築する 📝☀️📰

📖 プロジェクトの説明

このプロジェクトでは、MCP mcp[cli] Python SDK を使って構築したシンプルな MCP サーバーを紹介します。MCP サーバーを通じて、次のようなツールを提供します。

• ノート管理： ローカルに保存されたノートの追加、読み取り、最新のノートの取得、要約の生成を行います。
• 天気情報： WeatherAPI.com サービスを使用して、指定した都市の現在の天気情報を取得します。
• ニュース検索： Brave Search API を使用してニュースを検索します。

外部サービス用の API キーは、.env ファイルに保存して使用します。

🛠️ セットアップ手順

以下の手順に従って、FastMCP エージェントを起動してください。

1. 前提条件：

   • Python 3.12 がインストールされていること。
   • 仮想環境マネージャー（venv、pipenv、poetry、uv など）の使用を推奨します。

2. リポジトリをクローンする（まだクローンしていない場合）：

   # 正しい親ディレクトリにいることを確認してください
   git clone https://github.com/sourangshupal/Build-Custom-MCP-Servers # または、すでにクローン済みの場合は現在のディレクトリを使用します
   cd Build-Custom-MCP-Servers 
   

3. 仮想環境をセットアップして依存関係をインストールする：

   • 依存関係をインストールします（uv.lock に基づき uv を使用する場合。pip/poetry を使用する場合は適宜変更してください）。

     uv sync
     uv lock
     source .venv/bin/activate  # Windows の場合は `.venv\Scripts\activate` を使用します
     

   • または

     pip install uv # uv がインストールされていない場合
     uv pip install -r requirements.txt # pyproject.toml を直接使用する場合は uv sync
     # uv を使用しない場合は、通常 pip install -r requirements.txt、poetry install、または pip install . を使用します
     

4. 環境変数を設定する：

   • サンプル環境ファイルをコピーします。

     cp .env.example .env
     

   • 新しく作成した .env ファイルを編集し、API キーを追加します。

     WEATHER_API_KEY="YOUR_WEATHER_API_KEY"
     BRAVE_API_KEY="YOUR_BRAVE_API_KEY"
     

5. エージェントを実行する：

   • メインスクリプトを実行します。

     mcp install main.py
     

   • FastMCP サーバーが Claude Desktop に追加されます。

     mcp dev main.py
     

   • MCP サーバーをデバッグします。

✨ 機能

• ノート作成機能（追加、読み取り、最新のノートの取得、要約）📝
• 現在の天気情報の取得 ☀️
• ニュース検索のための Brave Search 連携 📰
• .env ファイルによる設定 🔑
• mcp[cli] を使用して構築 ⚙️

🤝 コントリビューション

コントリビューションを歓迎します。プルリクエストを送信するか、イシューを作成してください。