casperjuel/abrp-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

10 stars 4 forks Качество 75 Тренд 22MIT

Unofficial MCP server for the A Better Route Planner (ABRP) / Iternio EV routing API — plan EV routes with charging stops from any MCP client. Hono + Vercel.

Обзор

An Model Context Protocol server for the A Better Route Planner (ABRP) / Iternio EV routing API. Built with Hono and deployable on Vercel as a single serverless function. It exposes ABRP's EV route planner — route + charging stops, charge curves, charger search, vehicle models, range estimates, and live telemetry — as MCP tools, with a stateless OAuth flow so each user supplies their own API key. Not affiliated with, endorsed by, or sponsored by Iternio. "A Better Route Planner" and "ABRP" are trademarks of Iternio AB. ⚠️ This is a weekend project. The /plan endpoint is billed per call by Iternio — read the code and mind your API key before connecting an LLM. A public instance runs at — MCP endpoint . It holds no API key: every user authorizes with their own ABRP key via the built-in OAuth flow (nothing is stored server-side; your key is sealed into the access token). Point any OAuth-capable MCP client at the /mcp URL, or self-host your own (see Deploy to Vercel).

README

Показан фрагмент оригинального README. Открыть оригинал.

abrp-mcp

An unofficial Model Context Protocol server for the A Better Route Planner (ABRP) / Iternio EV routing API. Built with Hono and deployable on Vercel as a single serverless function.

It exposes ABRP’s EV route planner — route + charging stops, charge curves, charger search, vehicle models, range estimates, and live telemetry — as MCP tools, with a stateless OAuth flow so each user supplies their own API key.

Not affiliated with, endorsed by, or sponsored by Iternio. “A Better Route Planner” and “ABRP” are trademarks of Iternio AB.

⚠️ Hobby experiment, no guarantees. This is a weekend project. The /plan endpoint is billed per call by Iternio — read the code and mind your API key before connecting an LLM.

Hosted instance

A public instance runs at https://abrp-mcp.vercel.app — MCP endpoint https://abrp-mcp.vercel.app/mcp. It holds no API key: every user authorizes with their own ABRP key via the built-in OAuth flow (nothing is stored server-side; your key is sealed into the access token). Point any OAuth-capable MCP client at the /mcp URL, or self-host your own (see Deploy to Vercel).

Quick start — no terminal, no install

You don’t need to be a developer or run anything. Using the hosted instance and Claude Desktop:

Get an ABRP API key — see Getting an API key below.
Open Claude Desktop → Settings → Connectors → Add custom connector.
Name it ABRP and paste the URL https://abrp-mcp.vercel.app/mcp, then add it.
A login page opens — paste your API key and click Authorize. (Nothing is stored on the server; your key is sealed into your own access token.)
Start a new chat and just ask, e.g. “Plan a route from Copenhagen to Berlin in a VW ID.4, I’m at 80%.”

That’s it — no JSON files, no terminal. (Other MCP-capable assistants that support custom remote connectors work the same way; point them at the same URL.) The honest catch is step 1 — getting a key still takes a moment; see below.

Tools

Tool	What it does	Auth
`abrp_check_access`	Validate the API key against a free endpoint	API key
`abrp_find_vehicle`	Search the model catalogue by name → exact `typecode`	API key
`abrp_plan_route`	Plan an EV route with charging stops (friendly inputs)	API key
`abrp_plan_trip`	Plan a long route split into dated daily legs (max-hours/day, daily start time) + overnight stops	API key
`abrp_plan_raw`	Plan with a full raw `PlanRequest` body	API key
`abrp_refresh_route`	Re-optimise an in-progress route from live position/SoC	API key
`abrp_search_networks`	Find charging-network ids (for network preferences)	API key

Открыть полный README на GitHub

Установка

npx -y mcp-remote https://localhost:3000/mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "abrp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://localhost:3000/mcp"],
      "env": {
        "NODE_EXTRA_CA_CERTS": "/Users/<you>/Library/Application Support/mkcert/rootCA.pem"
      }
    }
  }
}