服务注册与分布式协调 / 系统课时
用 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 调用。

先安装 Wrapper,并确认本机能够访问 Nacos。下面的安装命令只安装依赖,不会启动服务。
python -m pip install nacos-mcp-wrapper-python预期结果
依赖安装成功,命令以退出码 0 结束;具体下载日志与版本号可能不同。实现 Python Server
将下面代码保存为 server.py。示例把 Nacos 地址、命名空间、账号和 MCP 监听端口放到环境变量中,避免把环境相关值写死在源码里。
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")预期结果
文件可被 Python 解释器加载;真正的服务启动与注册发生在下一步运行 server.py 时。启动并验证注册
在运行前注入真实环境值。<HOST>、<PORT>、<USERNAME> 与 <PASSWORD> 都需要替换;Nacos 端口与 MCP Server 端口可以不同。
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预期结果
server.py 保持前台运行且没有 Python 异常退出。
Nacos 的 MCP 服务目录中可以找到 weather-python 1.0.0,并能看到当前可用的运行端点或实例。此时应同时核对服务名、版本、传输协议和工具 get_weather。如果只看到服务定义却没有可用实例,不要把“注册成功”和“服务可调用”混为一件事,还要继续检查监听地址、端口和网络连通性。
观察停止后的状态
在运行 server.py 的终端按 Ctrl+C 停止进程,然后等待注册中心完成状态刷新。验证重点是运行实例不再可用;服务目录中的元数据是否仍保留,不应作为判断进程是否存活的唯一依据。
如果重新启动相同服务名和版本,Wrapper 会再次提交当前服务与工具信息。出现 mcp server info is not compatible 或类似兼容性错误时,优先对比传输协议、服务引用、工具名称、工具数量、参数类型与必填关系,而不是直接删除目录数据。