🚲VanMoof MCP Server

🚲VanMoof MCP 服务

VanMoof MCP 服务实现了 MCP 规范，在 AI Agent 与 VanMoof 的重要服务之间建立无缝连接，例如 VanMoof 客户数据，包括自行车详情、VanMoof 骑行者所在城市、骑行偏好和每周骑行记录。

🎯 概述

✨ VanMoof MCP 服务能做什么？

VanMoof MCP 服务为你的 Agent 提供丰富的 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 检查器是一款用于测试和调试 MCP 服务的开发工具。

在本地调试和测试之前，请使用你的 VanMoof 凭据配置 .env 文件。

将 .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 检查器后，在 Webbrowser 中配置 VANMOOF_USERNAME 和 VANMOOF_PASSWORD 的环境参数。

启动 MCP Inspector

有两种方式可以启动 MCP Inspector：

• 使用 MCP CLI 启动
• 使用 npx @modelcontextprotocol/inspector 启动

如果你通过 cli 选项安装 SDK，例如 uv add "mcp[cli]"，就可以使用 MCP CLI。运行 mcp dev 即可启动 MCP Inspector。

如果你想使用 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