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"
     }
]

安全注意事项

⚠️ 重要安全警告：

• 当前实现使用 exec() 执行从 JSON 文件读取的代码
• 在生产环境中需要采取额外的安全措施：
  • 代码签名验证
  • 沙箱环境限制
  • 代码审查机制
  • 访问控制

开发建议

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]