ESGO

ESGO MCP 服务

德语版本见下文

让 AI 助手（Claude、Cursor、VS Code、Windsurf，以及其他支持 Model Context Protocol 的工具）以通俗语言使用 ESGO API：搜索公路货运中的匹配空驶运力， 并发布开放的运输需求。

“查找下周从 47057 Duisburg 到 80331 München、载重 12 t 的空闲运力。”

Alpha 版。 工具会自动遵循 ESGO API v1（见下文）。

工作原理

ESGO API 的每个操作都会对应一个工具。服务启动时，会根据实时 OpenAPI 规范 api.es-go.de/v1/openapi.json 动态构建工具。 ESGO 新增端点后，下次启动服务时即可将其作为工具使用，无需更新此软件包。如果启动时 无法访问 API，服务会使用随附的规范副本。

仅读取数据的工具（me_retrieve、matches_search、open_requests_list_matches） 会标记为只读；创建数据的工具（open_requests_create）则不会，因此助手会在调用前征求你的同意。

访问权限

你需要 ESGO API 密钥；目前尚未开放自助注册。请通过 es-go.de/developers 申请访问权限。密钥会保留在你的 设备上，且只会发送给 ESGO API。

安装

服务在本地运行，并由你的 AI 应用启动。你需要安装 uv；uvx 会按需下载并运行软件包。

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）、 Windsurf 和其他采用相同格式的应用：

{
  "mcpServers": {
    "esgo": {
      "command": "uvx",
      "args": ["esgo-mcp"],
      "env": { "ESGO_API_KEY": "esgo_live_..." }
    }
  }
}

Claude Code：

claude mcp add esgo -e ESGO_API_KEY=esgo_live_... -- uvx esgo-mcp

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "esgo": {
      "command": "uvx",
      "args": ["esgo-mcp"],
      "env": { "ESGO_API_KEY": "esgo_live_..." }
    }
  }
}

不使用 uv：运行 pip install esgo-mcp，然后将 esgo-mcp 用作命令。

变量	含义
ESGO_API_KEY	你的 ESGO API 密钥（调用时必需）
ESGO_BASE_URL	可选，默认值为 https://api.es-go.de

工具（截至 2026 年 10 月）

列表直接来自 API，因此你阅读本文时，工具可能已经更多。

工具	端点	是否更改数据
me_retrieve	GET /v1/me	否
matches_search	POST /v1/matches/search	否
open_requests_create	POST /v1/open-requests	是
open_requests_list_matches	GET /v1/open-requests/{request_id}/matches	否

API 错误（例如 [429] daily_quota_exceeded 或 [422] invalid_parameter (param: weight_kg)）会作为工具错误返回给助手，以便助手修正输入或告知你。

相关资源

• Python SDK：pypi.org/project/esgo
• .NET SDK：nuget.org/packages/Esgo
• API 参考：api.es-go.de/v1/docs
• 更新日志：CHANGELOG.md

许可证

MIT，详见 LICENSE。

---

ESGO MCP 服务（德语）

借助此服务，AI 助手（Claude、Cursor、VS Code、Windsurf，以及其他支持 Model Context Protocol 的工具）可以使用 ESGO API， 以通俗语言搜索公路货运中的匹配空驶运力，并发布开放的运输需求。

工作原理： ESGO API 的每个端点都会对应一个工具。服务启动时，会根据当前的 OpenAPI 规范构建工具。这样，新增端点会在下次启动时自动可用，无需更新此软件包。 如果启动时无法访问 API，服务会使用随附的规范副本。创建数据的工具会相应标记； 助手会事先征求同意。

访问权限： 你需要 ESGO API 密钥，请通过 es-go.de/developers 申请。密钥会保留在你的设备上， 且只会发送给 ESGO API。

设置： 请参阅上方的配置示例。需要安装 uv；uvx esgo-mcp 会下载并启动软件包。

许可证： MIT，详见 LICENSE。