ANWB交通信息服务器

anwb mcp

一个 模型上下文协议 （MCP） ANWB 在荷兰的交通信息、路线规划和位置搜索服务器。获取实时文件信息，使用分步路线计算路线，并搜索位置 - 所有这些都是通过人工智能应用程序中的自然语言。

让我们来： 这是一个非官方的，由社区维护的项目，不与ANWB相关或批准。此服务器使用公开可访问的 ANWB API 端点，不需要 API 密钥。

社区建设 模型上下文协议 （MCP）服务器，用于荷兰的ANWB交通信息、路线规划和位置搜索。获取实时交通事件，计算路线和转弯方向，并搜索位置——所有这些都是通过任何兼容MCP的AI客户端使用自然语言完成的。

注： 这是一个非官方的、由社区维护的项目，不隶属于ANWB或得到ANWB的认可。此服务器使用可公开访问的ANWB API终结点-不需要API密钥。

快速启动

你不需要克隆这个仓库。

1. 确保安装了 Node.js 20+（您的 AI 应用程序正在运行） npx op-je机器）
2. 将服务器添加为 AI 应用程序中的 MCP 服务器（复制下面的配置）
3. 用简单的荷兰语提问（见 例子)

快速入门（非开发人员）

您不需要克隆此仓库。

1. 确保已安装Node.js 20+（您的AI应用程序将运行 npx 在您的机器上）
2. 将服务器作为MCP服务器添加到您的AI应用程序中（复制/粘贴下面的配置）
3. 用通俗易懂的语言提问（见 示例用法)

添加到Claude桌面（也适用于协作）

Cowork在Claude Desktop内部运行，并使用相同的连接MCP服务器和权限。

1. 打开您的Claude Desktop MCP配置文件：
   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • 窗户： %APPDATA%\Claude\claude_desktop_config.json
2. 添加此服务器条目（或将其合并到现有的 mcpServers):

{
  "mcpServers": {
    "anwb-mcp": {
      "command": "npx",
      "args": ["-y", "anwb-mcp"]
    }
  }
}

3. 重新启动克劳德桌面

添加到其他AI应用程序

大多数MCP应用程序都有一个类似“添加MCP服务器”的屏幕，您可以在其中填写：

• 命令： npx
• Args： -y anwb-mcp

如果你的应用程序需要JSON，粘贴它并将顶级键名调整到你的客户端（常见的是 mcpServers, servers，或 context_servers):

{
  "<servers-key>": {
    "anwb-mcp": {
      "command": "npx",
      "args": ["-y", "anwb-mcp"]
    }
  }
}

故障排除

• 错误： npx: command not found 或服务器无法启动
  • 修复：安装Node.js 20+并重新启动应用程序。
• 空结果或连接错误
  • ANWB API可能暂时不可用。请稍等，然后重试。

特性

• 6工具 涵盖交通、路线和位置搜索的3个类别
• 位置搜索 --使用坐标查找地址、城市、街道和兴趣点
• 路线规划 --按汽车、房车、自行车（普通或电动自行车）或步行计算路线，包括距离、持续时间、转弯方向、收费信息和替代路线
• 电动汽车路线规划 --根据电池消耗、充电站以及与燃料相比的成本节约来规划电动汽车路线
• 电动汽车数据库 --浏览1500多种带有电池规格的电动汽车型号，以进行电动汽车路线规划
• 道路避让 --避开收费公路、高速公路、渡轮或未铺砌的道路
• 交通事件 --荷兰高速公路上的实时拥堵、道路封闭、道路施工和测速摄像头位置
• 交通量汇总 --所有高速公路当前交通状况的简明概述
• 不需要API密钥 --使用可公开访问的ANWB端点
• 输入验证 通过每个工具上的Zod模式实现安全、可预测的操作
• 响应缓存 具有可配置的TTL（路线和事件为60秒，位置为300秒）
• 费率限制处理 具有指数回退和 Retry-After 标头支持
• 工具集过滤 仅公开所需的工具类别
• Docker支持 通过GHCR进行集装箱化部署
• 可操作的错误消息 具有上下文感知的恢复建议

支持的客户

claude mcp add --scope user anwb-mcp -- npx -y anwb-mcp

codex mcp add anwb-mcp -- npx -y anwb-mcp

gemini mcp add anwb-mcp -- npx -y anwb-mcp

docker run -i --rm ghcr.io/bartwaardenburg/anwb-mcp

[mcp_servers.anwb-mcp]
command = "npx"
args = ["-y", "anwb-mcp"]

配置

不需要API密钥。以下可选环境变量可用：

可用工具

位置

路线

事件

工具集筛选

通过仅启用所需的工具类别来减少上下文窗口的使用。设置 ANWB_TOOLSETS 将环境变量转换为逗号分隔的列表：

ANWB_TOOLSETS=routes,incidents

如果未设置，则启用所有工具集。无效名称将被忽略；如果所有名称都无效，则启用所有工具集作为回退。

例子

一旦连接，您可以用简单的荷兰语提问：

• “搜索阿姆斯特丹附近的地点”
• “Eindhoven Centraal的坐标是什么？”
• “计算从阿姆斯特丹到埃因霍温的路线”
• “计划从Utrecht Centraal到De Uithof的自行车路线”
• “你要从水坝走多久才能到达Vondelpark公园？”
• “从乌得勒支到海牙的最快路线是什么？”
• “A2公路上有人吗？”
• “现在有哪些道路工程？”
• “交通摘要”
• “A1上有哪些闪光灯？”
• “计划从Ede到Zwolle没有收费公路的路线”
• “计算从阿姆斯特丹到Veluwe的大篷车路线”
• “计划从乌得勒支到阿默斯福特的电动自行车路线”
• “特斯拉有哪些电动汽车？”
• “使用特斯拉Model 3计划从阿姆斯特丹到马斯特里赫特的EV路线”
• “如果没有高速公路，从鹿特丹到格罗宁根需要多长时间？”

示例用法

连接后，您可以使用自然语言与ANWB API进行交互：

• “搜索阿姆斯特丹附近的地点”
• “找到埃因霍温中心的坐标”
• “计算从阿姆斯特丹到埃因霍温的路线”
• “计划从Utrecht Centraal到De Uithof的自行车路线”
• “从水坝广场步行到冯德尔公园需要多长时间？”
• “从乌得勒支到海牙最快的路线是什么？”
• “A2公路上有交通堵塞吗？”
• “显示所有当前的道路工程”
• “给我一个交通摘要”
• “A1上有哪些测速摄像头？”
• “规划一条从Ede到Zwolle的路线，避免通行费”
• “计算从阿姆斯特丹到Veluwe的商队路线”
• “规划从乌得勒支到阿默斯福特的电动自行车路线”
• “特斯拉有哪些电动汽车？”
• “用特斯拉Model 3规划从阿姆斯特丹到马斯特里赫特的电动汽车路线”
• “从鹿特丹开车到格罗宁根避开高速公路需要多长时间？”

社区

• 技术支持： 支持.md
• 安全报告： 安全.md
• 贡献指南： 贡献.md
• Bug报告和功能请求： 问题

发展

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Run tests
pnpm test

# Type check
pnpm typecheck

项目结构

src/
  index.ts              # Entry point (stdio transport)
  server.ts             # MCP server setup and toolset filtering
  anwb-client.ts        # ANWB API HTTP client with caching and retry
  cache.ts              # TTL-based in-memory response cache
  types.ts              # TypeScript interfaces for ANWB API responses
  tool-result.ts        # Error formatting with recovery suggestions
  update-checker.ts     # NPM update notifications
  tools/
    locations.ts        # Location and address search
    routes.ts           # Route calculation with directions
    incidents.ts        # Traffic incidents and summary

需求

• Node.js>=20

许可证

麻省理工学院-见 许可证 了解详情。