MCP Hot Update Server Demo

MCP ホットアップデートサーバーのデモ

中国語ドキュメント | このリポジトリの DeepWiki

これは FastMCP フレームワークをベースにしたホットアップデートサーバーのサンプルで、サーバーを再起動せずにユーティリティ関数を動的に読み込み、更新できます。

特長

• ユーティリティ関数の動的読み込みに対応
• JSON 設定ファイルを使ったツールの管理
• リアルタイムのホットアップデート機能
• 詳細なエラー処理とログ記録

主なコード

exec(tool_code, globals(), local_namespace)
if inspect.isfunction(obj) and obj.__name__ in local_namespace:
     if found_func is not None:
          # Handle potential duplicate function definition if needed
          pass # Or log a warning, raise an error, etc.
     found_func = obj
if found_func:
     # Add the tool to MCP using the database name
     mcp.tool(
          name=tool_name, description=tool_description
     )(found_func)
     print(f"Successfully registered tool '{tool_name}'")

🚀 クイックスタート

1️⃣ 環境のセットアップ

Python 3.7+ がインストールされていることを確認してください。次に、必要なライブラリをインストールします。

$ pip install fastmcp

• fastmcp: MCP の Python 実装ライブラリです。

2️⃣ MCP サーバーの実行

$ python server.py

• tools.json ファイルの形式は次のとおりです。

[
     {
          "name": "Tool Name",
          "description": "Tool Description",
          "code": "def function_name(params):\n    # Function implementation\n    return result"
     }
]

セキュリティに関する注意事項

⚠️ 重要なセキュリティ警告：

• 現在の実装では、JSON ファイルから読み込んだコードの実行に exec() を使用しています
• 本番環境では、追加のセキュリティ対策が必要です：
  • コード署名の検証
  • サンドボックス環境の制限
  • コードレビューの仕組み
  • アクセス制御

開発に関する提案

1. 開発環境ですべてのユーティリティ関数をテストします
2. JSON ファイルの形式が正しいことを確認します
3. 適切なエラー処理を追加します
4. コードレビューのプロセスを導入します
5. バージョン管理の仕組みの導入を検討します

ワークフロー

graph TD
     A[Start Server] --> B[Load tools.json]
     B --> C{Parse JSON}
     C -->|Success| D[Iterate Tool List]
     C -->|Failure| E[Output Error Log]
     D --> F[Execute Tool Code]
     F --> G{Code Execution}
     G -->|Success| H[Register to MCP]
     G -->|Failure| I[Output Error Log]
     H --> J[Server Running]
     J --> K[Wait for New Requests]