本项目是一个基于 Google OR-Tools 的路径规划服务器,集成在腾讯云 MCP (Multi-Cloud Platform) 体系中。它能够接收路径规划请求,利用 OR-Tools 计算最优路径,并将结果通过 API 返回或生成 HTML 地图进行可视化展示。
目前项目包含一个示例,用于展示车辆路径问题 (VRP) 的解算和在地图上的可视化。
- 使用 Google OR-Tools进行车辆路径问题 (VRP) 求解。
- 提供 HTTP API 接口用于路径规划请求。
- 生成 HTML 文件以可视化路径规划结果 (例如
mcp_servers/or_tools_server/vrp_route_map_v5_loc35_depot0.html)。
mcp_servers/
or_tools_server/ # OR-Tools 服务器核心代码
main.py # FastAPI 应用入口
requirements.txt # Python 依赖
*.html # 路径规划结果可视化示例
requirements.txt # 项目全局依赖 (如果与 or_tools_server/requirements.txt 不同)
venv/ # Python 虚拟环境
README.md # 本文件
-
克隆项目 (如果您尚未克隆):
git clone <repository_url> cd tencentmcp
-
创建并激活 Python 虚拟环境:
python3 -m venv venv source venv/bin/activate对于 Windows 用户:
python -m venv venv venv\Scripts\activate
-
安装依赖: 首先,检查
mcp_servers/or_tools_server/requirements.txt是否存在且包含所有必要的依赖。如果项目根目录下也有requirements.txt,请确认哪个是主要的依赖文件。 假设mcp_servers/or_tools_server/requirements.txt是主要的依赖文件:pip install -r mcp_servers/or_tools_server/requirements.txt
如果根目录下的
requirements.txt也是必需的,则也需要安装它:pip install -r requirements.txt
启动 OR-Tools 服务器通常涉及运行 main.py 文件,该文件可能使用 FastAPI 和 Uvicorn。
根据 toolcall_history 中的后台命令,服务器可能是这样启动的:
-
直接运行 Python脚本 (可能用于开发或特定任务):
cd /Users/guohongbin/projects/tencentmcp /Users/guohongbin/projects/tencentmcp/venv/bin/python mcp_servers/or_tools_server/main.py -
使用 Uvicorn 启动 FastAPI 应用 (推荐用于生产或提供 API 服务):
cd /Users/guohongbin/projects/tencentmcp/mcp_servers/or_tools_server /Users/guohongbin/projects/tencentmcp/venv/bin/uvicorn main:app --host 0.0.0.0 --port 8000
启动后,您可以根据 main.py 中定义的 API 端点与服务器进行交互,或者查看生成的 HTML 文件 (如 vrp_route_map_v5_loc35_depot0.html) 来观察路径规划结果。
- 确保您的 Python 环境已正确配置,并且所有依赖项都已成功安装。
- 如果遇到与腾讯地图 API 相关的速率限制错误 (如
toolcall_1和toolcall_2中所示的 "此key每秒请求量已达到上限"),您可能需要检查 API 密钥的配额或使用频率。
欢迎为此项目做出贡献。请通过提交 Pull Request 或创建 Issue 的方式参与。
(请在此处添加项目的许可证信息,例如 MIT, Apache 2.0 等)