Hello MCP Server Python

🚀 MCP サーバードキュメント

このプロジェクトは、Model Context Protocol (MCP) を使用して実装されたサーバーサイドツールです。Claude AI などの大規模言語モデル (LLM) への機能サポートを目的としています。現在、サーバーは BMI 計算と天気情報照会の 2 つの主要なサービスを提供しています。

🚀 クイックスタート

この MCP サーバーを使用することで、Claude AI などの大規模言語モデルに BMI 計算や天気情報照会の機能を追加できます。以下の手順に従って、サーバーをセットアップして使用しましょう。

✨ 主な機能

• BMI 計算：calculate_bmi ツールを使用して、身長と体重から BMI 指数を計算できます。
• 天気情報照会：fetch_weather ツールを使用して、指定した都市の天気情報を取得できます。

📦 インストール

システム要件

• オペレーティングシステム：Linux または macOS の使用をおすすめします。Windows でも動作しますが、一部の機能が制限される場合があります。
• Python バージョン：3.9 以上のバージョンが必要です。
• 開発環境：基本的な Python およびコマンドライン操作の知識が必要です。

インストール手順

1. コードリポジトリをクローンします：

   git clone https://github.com/yourusername/hello-mcp-server-python.git
   cd hello-mcp-server-python
   

2. 依存関係をインストールします：

   pip install httpx "mcp[cli]"
   

3. サーバーを起動します（オプション、MCP またはコマンドラインで実行）：

   python server.py
   # または MCP CLI を使用
   mcp run server.py
   

📚 ドキュメント

サーバー設定

MCP 設定ファイル (mcp.json)

プロジェクトのルートディレクトリに mcp.json ファイルを作成または編集し、以下の内容を追加してサーバーを設定します。

{
  "mcpServers": {
      "mcp-server-python": {
            "command": "mcp",
            "args": [
                "run",
                "/path/to/server.py"
                ]
      }
  }
}

コマンドラインでの実行

ターミナルで以下のコマンドを実行してサーバーを起動します。

python server.py

機能説明

提供されるツール

1. calculate_bmi：身長（cm）と体重（kg）を入力として受け取り、BMI 指数を出力します。
2. fetch_weather：都市名に基づいて天気情報を照会します。

使い方の例

• BMI 計算：

  calculate_bmi --height 170 --weight 65
  

  出力結果は BMI 値です。

• 天気照会：

  fetch_weather --city "北京"
  

  指定した都市の天気詳細が返されます。

環境変数設定

API キーの設定

server.py ファイルに以下のコードを追加して、天気 API のキーを設定します。

API_KEY = "your_api_key_here"  # 実際の API キーに置き換えてください

プロジェクト構造

hello-mcp-server-python/
├── server.py       # MCP サーバーのメインプログラムファイル
└── requirements.txt  # 依存関係管理ファイル（オプション）

使用方法

MCP を介した接続

1. Cursor IDE を開き、プロジェクトを読み込みます。
2. mcp.json ファイルが存在し、正しく設定されていることを確認します。
3. Cursor でサーバーを実行すると、MCP ツールが自動的に認識されて使用可能になります。

コマンドラインでの使用

1. Claude for Desktop をインストールします。
2. ターミナルでサーバーを起動します：

   python server.py
   

3. Claude のインターフェイスで MCP サーバーにアクセスして対話します。

よくある質問

• 天気 API キーはどのように取得できますか？

  • 関連する天気サービスプロバイダーに連絡して、無料の試用キーを申請できます。

• サーバーの起動に失敗した場合はどうすればいいですか？

  • ネットワーク接続と依存関係が正しくインストールされていることを確認し、ターミナルに表示されるエラーメッセージを確認します。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細は LICENSE ファイルを参照してください。

参考資料

• Model Context Protocol ドキュメント
• MCP Python SDK ドキュメント
• httpx 公式ドキュメント
• Claude AI 開発ドキュメント