Xiaozhi MCP MapNAVI | MCP地图导航工具

一款强大的MCP工具，集成Amap API服务，允许AI访问地理信息、天气数据和路线规划。

概述

MCP-MapNAVI基于模型上下文协议（MCP），使AI语言模型能够与外部地图服务进行交互。通过此工具，AI可以进行地址编码、查询天气信息以及规划驾驶路线——扩展了其文本生成之外的能力。

特性

• 🗺️ 地址编码 - 将地址转换为经纬度坐标
• 🌤️ 天气查询 - 获取特定城市或地区的天气信息
• 🚗 驾驶路线规划 - 规划两点之间的驾驶路线
• 🔄 自动重连 - 带有指数退避机制的WebSocket连接恢复机制
• 🔒 安全通信 - 通过WebSocket实现的安全数据传输

快速开始

1. 安装依赖：

pip install -r requirements.txt

2. 设置环境变量：

export MCP_ENDPOINT=<your_mcp_endpoint>

3. 运行map_navi示例：

python mcp_pipe.py map.py

项目结构

• mcp_pipe.py: 主通信管道，处理WebSocket连接和进程管理
• calculator.py: 数学计算的MCP工具示例实现
• requirements.txt: 项目依赖

创建自己的MCP工具

这里是一个创建MCP工具的简单示例：

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("YourToolName")

@mcp.tool()
def your_tool(parameter: str) -> dict:
    """在此处描述工具"""
    # 您的实现
    return {"success": True, "result": result}

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

使用场景

• 数学计算
• 邮件操作
• 知识库搜索
• 远程设备控制
• 数据处理
• 自定义工具集成

环境要求

• Python 3.7+
• websockets>=11.0.3
• python-dotenv>=1.0.0
• mcp>=1.8.1
• pydantic>=2.11.4

贡献指南

欢迎贡献代码！请随时提交Pull Request。

许可证

本项目采用MIT许可证——详情请参阅LICENSE文件。

致谢

• 感谢所有帮助塑造这个项目的贡献者
• 受到对可扩展AI能力需求的启发