Compare commits

...
Author SHA1 Message Date
hrz 744ff26932 接入点文档里那句指代改清楚
样例有四行日志,只有第一行的措辞会跟着镜像版本变,原来说「这行」读者对不上是哪一行,改成明说第一行。
2026-10-27 10:53:15 +08:00
hrz 0d5f304eb0 接入点文档的地址提示跟外部项目当前输出对齐
那句改成多模块,并提醒措辞随镜像版本变化。
2026-10-27 10:00:12 +08:00
hrz 533a49a0bd 接入点文档的日志样例改成真实输出
两段样例按各自服务的实际格式写,token统一用abc占位。
2026-10-27 09:49:38 +08:00
hrz 1cc06169f2 MCP 接入点文档改对端口并去掉重复提示
单模块的 http 端口是 8003,文档里写的 8002 是智控台的端口,照抄会跟智控台撞上;同一句提示连写三遍,只留一句。
2026-10-27 09:19:56 +08:00
+20 -22
View File
@@ -37,30 +37,28 @@ docker logs -f mcp-endpoint-server
此时,日志里会输出类似以下的日志
```
250705 INFO-=====下面的地址分别是智控台/单模块MCP接入点地址====
250705 INFO-智控台MCP参数配置: http://172.22.0.2:8004/mcp_endpoint/health?key=abc
250705 INFO-单模块部署MCP接入点: ws://172.22.0.2:8004/mcp_endpoint/mcp/?token=def
250705 INFO-=====请根据具体部署选择使用,请勿泄露给任何人======
250705 13:04:20[0.0.7][src.server]-INFO-=====下面的地址分别是智控台/多模块MCP接入点地址====
250705 13:04:20[0.0.7][src.server]-INFO-智控台MCP参数配置: http://172.22.0.2:8004/mcp_endpoint/health?key=abc
250705 13:04:20[0.0.7][src.server]-INFO-单模块部署MCP接入点: ws://172.22.0.2:8004/mcp_endpoint/mcp/?token=abc
250705 13:04:20[0.0.7][src.server]-INFO-=====请根据具体部署选择使用,请勿泄露给任何人======
```
上面第一行(`=====下面的地址分别是…====`)的措辞跟着 mcp-endpoint-server 的镜像版本走,不同版本可能不一样,以你实际看到的输出为准。
请你把两个接口地址复制出来:
由于你是docker部署,切不可直接使用上面的地址!
由于你是docker部署,切不可直接使用上面的地址!
由于你是docker部署,切不可直接使用上面的地址!
你先把地址复制出来,放在一个草稿里,你要知道你的电脑的局域网ip是什么,例如我的电脑局域网ip是`192.168.1.25`,那么
原来我的接口地址
```
智控台MCP参数配置: http://172.22.0.2:8004/mcp_endpoint/health?key=abc
单模块部署MCP接入点: ws://172.22.0.2:8004/mcp_endpoint/mcp/?token=def
单模块部署MCP接入点: ws://172.22.0.2:8004/mcp_endpoint/mcp/?token=abc
```
就要改成
```
智控台MCP参数配置: http://192.168.1.25:8004/mcp_endpoint/health?key=abc
单模块部署MCP接入点: ws://192.168.1.25:8004/mcp_endpoint/mcp/?token=def
单模块部署MCP接入点: ws://192.168.1.25:8004/mcp_endpoint/mcp/?token=abc
```
改好后,请使用浏览器直接访问`智控台MCP参数配置`。当浏览器出现类似这样的代码,说明是成功了。
@@ -87,7 +85,7 @@ docker logs -f mcp-endpoint-server
```
server:
websocket: ws://你的ip或者域名:端口号/xiaozhi/v1/
http_port: 8002
http_port: 8003
log:
log_level: INFO
@@ -100,26 +98,26 @@ mcp_endpoint: 你的接入点websocket地址
```
server:
websocket: ws://你的ip或者域名:端口号/xiaozhi/v1/
http_port: 8002
http_port: 8003
log:
log_level: INFO
# 此处可能还更多配置
mcp_endpoint: ws://192.168.1.25:8004/mcp_endpoint/mcp/?token=def
mcp_endpoint: ws://192.168.1.25:8004/mcp_endpoint/mcp/?token=abc
```
配置好后,启动单模块会输出如下的日志。
```
250705[__main__]-INFO-初始化组件: vad成功 SileroVAD
250705[__main__]-INFO-初始化组件: asr成功 FunASRServer
250705[__main__]-INFO-OTA接口是 http://192.168.1.25:8002/xiaozhi/ota/
250705[__main__]-INFO-视觉分析接口是 http://192.168.1.25:8002/mcp/vision/explain
250705[__main__]-INFO-mcp接入点是 ws://192.168.1.25:8004/mcp_endpoint/mcp/?token=abc
250705[__main__]-INFO-Websocket地址是 ws://192.168.1.25:8000/xiaozhi/v1/
250705[__main__]-INFO-=======上面的地址是websocket协议地址,请勿用浏览器访问=======
250705[__main__]-INFO-如想测试websocket请启动digital-human模块,打开浏览器交互测试
250705[__main__]-INFO-=============================================================
250705 13:04:20[0.9.8_00000000000000][core.utils.modules_initialize]-INFO-初始化组件: vad成功 SileroVAD
250705 13:04:20[0.9.8_00000000000000][core.utils.modules_initialize]-INFO-初始化组件: asr成功 FunASRServer
250705 13:04:20[0.9.8_00000000000000][__main__]-INFO-OTA接口是 http://192.168.1.25:8003/xiaozhi/ota/
250705 13:04:20[0.9.8_00000000000000][__main__]-INFO-视觉分析接口是 http://192.168.1.25:8003/mcp/vision/explain
250705 13:04:20[0.9.8_00000000000000][__main__]-INFO-mcp接入点是 ws://192.168.1.25:8004/mcp_endpoint/mcp/?token=abc
250705 13:04:20[0.9.8_00000000000000][__main__]-INFO-Websocket地址是 ws://192.168.1.25:8000/xiaozhi/v1/
250705 13:04:20[0.9.8_00000000000000][__main__]-INFO-=======上面的地址是websocket协议地址,请勿用浏览器访问=======
250705 13:04:20[0.9.8_00000000000000][__main__]-INFO-如想测试websocket请启动digital-human模块,打开浏览器交互测试
250705 13:04:20[0.9.8_00000000000000][__main__]-INFO-=============================================================
```
如上,如果能输出类似的`mcp接入点是`中`ws://192.168.1.25:8004/mcp_endpoint/mcp/?token=abc`说明配置成功了。