Build Custom MCP Servers

🚀 カスタムMCPサーバー構築ガイド

このプロジェクトは、MCP mcp[cli] Python SDKを使用して構築されたシンプルなMCPサーバーを紹介しています。MCPサーバーを通じて公開されるいくつかのツールを提供します。

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

このプロジェクトは、.envファイルに保存されたAPIキーを利用して外部サービスを呼び出します。

🚀 クイックスタート

📦 インストール

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を使用する場合、uv.lockファイルに基づきます。それ以外の場合は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検索統合：ニュース検索に使用 📰
• .envファイルによる設定：キー管理を実現 🔑
• mcp[cli]を使用した構築 ⚙️

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

コントリビューションを歓迎します！自由にプルリクエストを送信するか、問題を開いてください。