Chargenow MCP

🚀 ChargeNow MCP サーバー

ChargeNow APIを使用した、電気自動車充電スタンド情報を提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、MCPプロトコルに対応したAIアシスタント（Claudeなど）が指定された住所の近くの電気自動車充電スタンドを検索できるようにします。

✨ 主な機能

• 指定された住所の近くで利用可能な電気自動車充電スタンドを検索します。
• 充電ポイントのリアルタイムの利用可能状況を取得します。
• 充電スタンドの詳細情報を確認できます。具体的には以下の情報が含まれます。
  • 検索位置からの距離
  • 住所と事業者情報
  • 利用可能なコネクタタイプと電力レベル
  • サポートされている支払い方法
  • 営業時間情報

📦 インストール

1. リポジトリをクローンします。
2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

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

💻 使用例

設定が完了したら、Claudeで以下のような質問をすることで充電スタンド検索機能を使用できます。

• "ベルリンのブランデンブルク門の近くの電気自動車充電スタンドを検索して"
• "ミュンヘンの中心部の近くに利用可能な充電ポイントはありますか？"
• "ベルリンのBautzener Strの近くの充電スタンドを表示して"

利用可能なツール

このMCPサーバーは以下のツールを提供します。

find_available_chargepoints

指定された住所の近くの利用可能な電気自動車充電ポイントを検索します。

パラメータ：

• 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

[...他の充電スタンド...]