🚲VanMoof MCP Server

🚲VanMoof MCP サーバー

VanMoof MCP サーバーはMCP 仕様を実装し、バイクの詳細、VanMoof ライダーの都市、ライダーの好み、週間走行データなどの VanMoof の顧客データを含む、VanMoof の主要なサービスと AI エージェントをシームレスに接続します。

🎯 概要

✨ VanMoof MCP サーバーでできること

VanMoof MCP サーバーを使うと、VanMoof ライダーのコンテキストをエージェントに追加できます。次のようなプロンプトを試してみてください。

🔍 顧客データを確認する

• 「私の VanMoof のバイクの詳細を教えてください。」
• 「私の VanMoof のバイクの名前は何ですか？」
• 「私の VanMoof のバイクのフレーム番号は何ですか？」
• 「私の VanMoof のバイクの色は何ですか？」

🏙️ 都市別の走行データ

• 「VanMoof の走行データが記録されている世界の都市はどこですか？」
• 「VanMoof の走行データが記録されているオランダの都市について、経度と緯度の列を含む表を作成してください。」
  「オランダで VanMoof の走行データが記録されている都市の一覧を取得し、経度と緯度の列を含む表にまとめます。」

⚙️ ライダーの好み

• 「私の VanMoof のライダー設定を取得してください」
• 「私の VanMoof のライダー設定では、どの都市が設定されていますか？」

🚲 VanMoof の走行データを確認する

• 「VanMoof での 2025-03-25 の週間走行統計を教えてください」
• 「私の VanMoof のバイクでの最高速度はどれくらいでしたか？」
• 「私の VanMoof のバイクでの最長走行距離はどれくらいでしたか？」
• 「今週の都市別統計を教えてください」
• 「今週の世界の自転車統計を教えてください」
• 「世界の統計と都市別統計を比較してください。何がわかりますか？」
• 「私の VanMoof の週間走行統計を都市別および世界の自転車統計と比較してください。比較結果を Markdown の表に保存してください。」

🛠️ 現在サポートされているツール

• get_customer_data：VanMoof の認証済みユーザーの顧客データを取得します
• get_vanmoof_cities：VanMoof API から都市データの一覧を取得します。
• get_rider_preferences：VanMoof の認証済みユーザーのライダー設定を取得します。
• get_rides_summary：VanMoof の認証済みユーザーの総走行概要を取得します。
• get_rides_for_week(date_in_week: str = "")：VanMoof の認証済みユーザーの特定の週の走行データを取得します。
• get_city_rides_thisweek：今週の VanMoof ライダーの都市別総走行概要を取得します。
• get_world_rides_thisweek：今週の VanMoof ライダーの世界全体の総走行概要を取得します。

🔌 はじめに

Python をインストールする

VanMoof MCP サーバーには Python が必要です。まだインストールしていない場合は、こちらの手順に従ってください。

uv をインストールする

uvもインストールしてください。これは Rust で書かれた、非常に高速な Python パッケージおよびプロジェクトマネージャーです。こちらの手順に従って uv をインストールしてください。

MCP-SERVER-VANMOOF Github リポジトリをクローンする。

ターミナルで以下のコマンドを実行します。

git clone https://github.com/stefanstranger/mcp-server-vanmoof

VanMoof MCP サーバーをテストおよびデバッグする

MCP Inspector は、MCP サーバーをテストおよびデバッグするための開発者ツールです。

ローカルでデバッグおよびテストする前に、.env ファイルに VanMoof の認証情報を設定してください。

.env-example ファイルの名前を .env に変更し、VanMoof の認証情報を設定してください。

VanMoof MCP サーバーをテストおよびデバッグするには、次を実行します。

mcp dev c:\github\mcp-server-vanmoof\server.py

次の引数を設定します。

run --with mcp[cli] --with requests --with tzlocal mcp run c://github//mcp-server-vanmoof//server.py

また、MCP Inspector を起動した後、Web ブラウザーで VANMOOF_USERNAME と VANMOOF_PASSWORD の環境変数を設定します。

MCP Inspector の起動

MCP Inspector を起動する方法は 2 つあります。

• MCP CLI で起動する
• npx @modelcontextprotocol/inspector で起動する

SDK を uv add "mcp[cli]" のように cli オプション付きでインストールすると、MCP CLI を使用できます。MCP Inspector を起動するには、mcp dev を実行します。

npx を使用して MCP Inspector を起動する場合は、ホストで Python 環境を起動した後、次のコマンドを実行します。

 npx @modelcontextprotocol/inspector uv run --with mcp[cli] --with requests --with tzlocal mcp run c://github//mcp-server-vanmoof//server.py -e [email protected] -e VANMOOF_PASSWORD=[very secret password]

🔧 セットアップ

Claude Desktop での使用

claude_desktop_config.json ファイルに以下を追加します。

{
  "mcpServers": {
    "mcp-server-vanmoof": {
            "type": "stdio",
            "command": "uv",
            "args": [
              "run",
              "--with",
              "mcp[cli]",
              "--with",
              "requests",
              "--with",
              "tzlocal",
              "mcp",
              "run",
              "C:\\Github\\mcp-server-vanmoof\\server.py"
            ],
            "env": {
              "VANMOOF_USERNAME": "[email protected]",
              "VANMOOF_PASSWORD": "[VanMoof user account password]"
            }
        }
  }
}

🛡️ セキュリティに関する注意

VanMoof の認証情報は、MCP クライアントの設定にプレーンテキストで保存されます。他の人と共有しないでください！！

参考資料

• ビルド設定なしで Model Context Protocol（MCP）サーバープロジェクトを作成する
• MCP Inspector