ESGO

ESGO MCP サーバー

ドイツ語版はこちら

Model Context Protocolに対応するAIアシスタント（Claude、Cursor、VS Code、Windsurfなど）から ESGO APIを利用できます。一般的な言葉で、道路貨物輸送の空車容量を検索したり、公開輸送依頼を登録したりできます。

「来週、47057 Duisburgから80331 Münchenまで、12 tを運べる空き容量を探してください。」

アルファ版。 ツールは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を参照してください。