服务注册与分布式协调 / 系统课时

用 Python 接入自动注册

用 Python 接入自动注册

本节把一个最小 Python MCP Server 接入 Nacos MCP Registry:用 Nacos MCP Wrapper 承担注册逻辑,配置 Registry 地址与服务元数据,并通过启动、停止两次观察确认目录信息和运行实例是否按预期变化。

学习目标

  • 使用 NacosSettings 与 NacosMCP 完成 Python MCP Server 自动注册。
  • 区分服务元数据与运行实例,能验证启动和停止后的状态变化。
  • 根据兼容性报错快速检查协议、工具结构与版本是否一致。

准备自动注册

自动注册链路包含三个角色:Python MCP Server 定义工具,Nacos MCP Wrapper 收集服务和工具元数据并注册,Nacos 负责目录管理与服务发现。应用不需要再单独编写一套注册 API 调用。

Python MCP Server 自动注册与停止生命周期

先安装 Wrapper,并确认本机能够访问 Nacos。下面的安装命令只安装依赖,不会启动服务。

bash
python -m pip install nacos-mcp-wrapper-python

预期结果

text
依赖安装成功,命令以退出码 0 结束;具体下载日志与版本号可能不同。

实现 Python Server

将下面代码保存为 server.py。示例把 Nacos 地址、命名空间、账号和 MCP 监听端口放到环境变量中,避免把环境相关值写死在源码里。

python
import os

from nacos_mcp_wrapper.server.nacos_mcp import NacosMCP
from nacos_mcp_wrapper.server.nacos_settings import NacosSettings

settings = NacosSettings()
settings.SERVER_ADDR = os.environ["NACOS_SERVER_ADDR"]
settings.NAMESPACE = os.environ.get("NACOS_NAMESPACE", "public")
settings.USERNAME = os.environ.get("NACOS_USERNAME", "")
settings.PASSWORD = os.environ.get("NACOS_PASSWORD", "")

# 服务名和版本用于目录识别;端口由部署环境注入。
mcp = NacosMCP(
    "weather-python",
    nacos_settings=settings,
    version="1.0.0",
    port=int(os.environ["MCP_PORT"]),
    instructions="Provide deterministic demo weather data.",
)

@mcp.tool()
def get_weather(city: str) -> str:
    """Return deterministic demo weather data for a city."""
    return f"{city}: sunny"

if __name__ == "__main__":
    mcp.run(transport="sse")

预期结果

text
文件可被 Python 解释器加载;真正的服务启动与注册发生在下一步运行 server.py 时。

启动并验证注册

在运行前注入真实环境值。<HOST>、<PORT>、<USERNAME> 与 <PASSWORD> 都需要替换;Nacos 端口与 MCP Server 端口可以不同。

bash
export NACOS_SERVER_ADDR="<HOST>:<PORT>"
export NACOS_NAMESPACE="public"
export NACOS_USERNAME="<USERNAME>"
export NACOS_PASSWORD="<PASSWORD>"
export MCP_PORT="<PORT>"
python server.py

预期结果

text
server.py 保持前台运行且没有 Python 异常退出。
Nacos 的 MCP 服务目录中可以找到 weather-python 1.0.0,并能看到当前可用的运行端点或实例。

此时应同时核对服务名、版本、传输协议和工具 get_weather。如果只看到服务定义却没有可用实例,不要把“注册成功”和“服务可调用”混为一件事,还要继续检查监听地址、端口和网络连通性。

观察停止后的状态

在运行 server.py 的终端按 Ctrl+C 停止进程,然后等待注册中心完成状态刷新。验证重点是运行实例不再可用;服务目录中的元数据是否仍保留,不应作为判断进程是否存活的唯一依据。

如果重新启动相同服务名和版本,Wrapper 会再次提交当前服务与工具信息。出现 mcp server info is not compatible 或类似兼容性错误时,优先对比传输协议、服务引用、工具名称、工具数量、参数类型与必填关系,而不是直接删除目录数据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Python 接入自动注册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通