bocha-mcp搜索MCP(部署于vm103)

给 OCtop 提供联网搜索能力的 MCP 服务:博查(Bocha)搜索 API 的 Python 封装,OCtop 的 agent 检索全网都走它。

访问方式

• 无独立 Web 端口;以 MCP 协议被 OCtop 调用(stdio/SSE,endpoint 待确认)
• 服务管理:systemctl status bocha-mcp
• SSH:ssh -i ~/.ssh/external_ai_key pev-yunmai2@100.64.0.20

技术架构

• /opt/bocha-mcp/server.py + 自带 venv(/opt/bocha-mcp/.venv/bin/python),56M 内存常驻
• /opt/bocha-mcp/api_key.txt:博查 API key(明文)
• MCP(Model Context Protocol)标准服务,注册到 OCtop 的工具列表中(server 名:"Bocha Search MCP Server for Octop")

数据(存储/备份情况)

• 无数据库;唯一资产是 api_key.txt
• pycache 为运行缓存,可随时删

使用方法

• OCtop 侧无需手工调用,agent 自动使用 search 工具
• 验证服务活着:systemctl is-active bocha-mcp;看调用日志:journalctl -u bocha-mcp -n 50

维护方式(启停/日志/配置)

• 重启:sudo systemctl restart bocha-mcp
• 换 key:改 api_key.txt 后重启服务
• 升级:替换 server.py(有 pycache,注意清理)后重启

现状与风险

• 低:api_key 明文;key 失效时 OCtop 联网搜索会批量报错(现象:agent 检索失败,先查这里)
• 无重大风险:单进程无状态,崩溃即 restart 恢复

优化建议(3-6条,给可直接执行的命令)

1. key 收权:sudo chmod 600 /opt/bocha-mcp/api_key.txt
2. 服务自愈确认:unit 已 enabled;加自动重启验证:grep -i restart /etc/systemd/system/bocha-mcp.service(无 Restart=on-failure 则补上)
3. key 失效演练:记下博查控制台账期,到期前轮换:sudo vim /opt/bocha-mcp/api_key.txt && sudo systemctl restart bocha-mcp
4. 日志降噪:调用频繁时 journalctl -u bocha-mcp -p warning 只看告警