返回 MCP 目录
public公开dns本地运行

chargenow-mcp

一个基于ChargeNow API的MCP服务器,提供电动汽车充电站信息查询功能,支持通过地址查找附近的充电站及其实时状态。

article

README

🚀 ChargeNow MCP 服务器

ChargeNow MCP 服务器借助 ChargeNow API,为用户提供电动汽车充电站信息。支持 MCP 协议的 AI 助手(如 Claude)可通过该服务器搜索指定地址附近的电动汽车充电站,极大提升了查找充电站的便利性。

🚀 快速开始

配置好服务器后,你就能在 Claude 中使用充电站搜索功能啦。比如提出以下问题:

  • "查找柏林勃兰登堡门附近的电动汽车充电站"
  • "慕尼黑市中心附近是否有可用的充电点?"
  • "显示柏林 Bautzener Str 附近的充电站"

✨ 主要特性

  • 精准查找:能在指定地址附近查找可用的电动汽车充电站。
  • 实时状态:可获取充电点的实时可用状态。
  • 详细信息:查看充电站的详细信息,涵盖:
    • 距离搜索位置的距离
    • 地址和运营商信息
    • 可用连接器类型及功率水平
    • 支持的支付方式
    • 营业时间信息

📦 安装指南

  1. 克隆仓库。
  2. 安装依赖:
npm install
  1. 构建项目:
npm run build

📚 详细文档

配置说明

该服务器需要地理编码服务的 API 密钥,可通过以下两种方式进行配置:

1. 环境变量

设置GEOCODE_API_KEY环境变量:

export GEOCODE_API_KEY="your_api_key_here"

2. MCP 服务器配置

当与 MCP 客户端(如 Claude)一起使用时,在您的 MCP 配置中进行如下设置:

{
  "mcpServers": {
    "chargenow": {
      "command": "node",
      "args": [
        "/path/to/chargenow-mcp/build/index.js"
      ],
      "config": {
        "geocodeApiKey": "your_api_key_here"
      }
    }
  }
}

请将/path/to/chargenow-mcp/build/index.js替换为构建文件的实际绝对路径。

Claude Desktop 配置

要在 Claude Desktop 中使用此服务器,需将以下内容添加到claude_desktop_config.json

{
  "mcpServers": {
    "chargenow": {
      "command": "node",
      "args": [
        "/path/to/chargenow-mcp/build/index.js"
      ],
      "config": {
        "geocodeApiKey": "your_api_key_here"
      }
    }
  }
}

文件位置如下:

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows:%APPDATA%\Claude\claude_desktop_config.json

💻 使用示例

基础用法

此 MCP 服务器提供了find_available_chargepoints工具,用于查找指定地址附近的可用电动汽车充电点。

{
  "name": "find_available_chargepoints",
  "parameters": {
    "address": "Bautzener Str Berlin"
  }
}

示例响应:

柏林Bautzener Str附近可用电充站:

摘要:
• 5个可用的充电点
• 2个充电点正在使用(充电中)
• 1个充电点离线

详细位置信息:

📍 柏林Mitte区充电站(0.89 公里外)
   地址:Brückenstraße 5, 10179 Berlin
   运营商:Allego
   支付方式:信用卡、RFID
   营业时间:全天24小时
   插头类型:CCS(150kW)、CHAdeMO(50kW)、Type 2(22kW)
   状态:
   • 2个可用点位
   • 1个正在充电
   最后更新时间:14:32:45

[...其他充电站...]
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端