MCP EV Assistant Server

基本能力

产品定位

MCP EV Assistant Server 是一个专注于电动汽车（EV）充电站管理、行程规划和资源管理的服务器。它通过提供一系列工具和API，帮助用户高效地管理电动汽车相关的服务。

核心功能

1. EV充电站服务
2. 充电站定位：根据位置和偏好查找附近的EV充电站
3. 插座类型过滤：搜索特定类型的充电插座（CCS、CHAdeMO、Type 2等）

4. 基于距离的搜索：指定搜索半径查找充电站

5. 行程规划

6. 路线规划：规划EV友好的路线
7. 充电站集成：自动包含必要的充电站停靠点

8. 续航考虑：考虑车辆续航和当前电量

9. 资源管理

10. PDF文档管理：处理与EV相关的PDF文档（用户指南、手册等）
11. 资源订阅：支持资源订阅以获取实时更新

12. 自动文本提取：PDF文本提取与备用机制

13. 交互式提示

14. 充电站搜索：交互式提示查找充电站
15. 充电时间估计：基于多种参数计算充电时间
16. 路线规划辅助：考虑充电需求的交互式路线规划

适用场景

• 电动汽车车主需要查找附近的充电站
• 需要规划长途行程并考虑充电站停靠点的用户
• 需要管理EV相关文档和资源的开发人员

工具列表

1. charge_points_locator
2. 能力：查找指定位置附近的EV充电站

3. 参数：地址、最大距离、插座类型

4. ev_trip_planner

5. 能力：规划EV友好的路线
6. 参数：起始位置、目的地、插座类型

常见问题解答

• 如何查找充电站？ 使用charge_points_locator工具，提供地址、最大距离和插座类型。

• 如何规划行程？ 使用ev_trip_planner工具，提供起始位置、目的地和插座类型。

• 如何处理PDF资源？ 将PDF文件放入/Data目录，服务器会自动发现并处理。

使用教程

使用依赖

1. 克隆仓库

git clone https://github.com/Abiorh001/mcp_ev_assistant_server.git
cd mcp_ev_assistant_server

1. 设置虚拟环境（推荐）

python -m venv .venv
source .venv/bin/activate  # On Linux/Mac
# or
.venv\\Scripts\\activate  # On Windows

1. 安装依赖

uv sync

安装教程

1. 创建.env文件并设置环境变量

OPENCHARGE_MAP_API_KEY=your_opencharge_map_api_key
GOOGLE_MAP_API_KEY=your_google_map_api_key

1. 配置servers_config.json

{
  "mcpServers": {
    "ev_assistant": {
      "command": "/home/$USER/path/mcp_learning/.venv/bin/python",
      "args": ["/home/$USER/path/mcp_ev_assistant_server/ev_assistant_server.py"],
      "env": {
        "OPENCHARGE_MAP_API_KEY": "your_opencharge_map_api_key",
        "GOOGLE_MAP_API_KEY": "your_google_map_api_key"
      }
    }
  }
}

调试方式

1. 启动服务器

python ev_assistant_server.py

1. 测试API

result = await client.call_tool("charge_points_locator", {
    "address": "London, UK",
    "max_distance": 10,
    "socket_type": "CCS"
})

许可证

该项目遵循 MIT 开源许可条款。