使用说明
瓦伦西亚Valenbisi自行车共享系统的MCP服务器
让你的人工智能助手找到最近的车站并解锁自行车——就在聊天中
将您的AI助手连接到Valenbisi。通过自然对话，询问哪些车站有自行车，按号码定位特定的自行车，或解锁自行车。
快速开始
1.安装
curl -sSL https://galimru.github.io/valenbisi-mcp/install.sh | sh
或者从以下网址下载二进制文件 发布页面.
2.连接到克劳德桌面
增添 claude_desktop_config.json:
{
"mcpServers": {
"valenbisi": {
"command": "/usr/local/bin/valenbisi-mcp",
"env": {
"VALENBISI_EMAIL": "you@example.com",
"VALENBISI_PASSWORD": "123456"
}
}
}
}
3.设置 app_token_key
创建或编辑 ~/.config/valenbisi-mcp/config.json:
{
"unlock_distance": 50,
"app_token_key": "APK_DERIVED_APP_TOKEN_KEY"
}
app_token_key 是API支持工具工作所必需的。它是
Cyclocity应用程序令牌密钥来自官方Android应用程序。
工具
| 工具 | 它做什么 |
|---|---|
get_nearest_stations |
距离GPS位置最近的站，按距离排序 |
get_nearest_stations_with_bikes |
最近有自行车出租的开放式车站 |
get_nearest_stations_with_stands |
最近的开放式车站有免费的停车场，可以归还自行车 |
get_station |
按编号列出的单个站点的详细信息 |
get_bike |
按编号查找自行车——返回其当前位置和停靠点 |
get_bikes_by_station |
列出目前在车站报告的自行车 |
unlock_bike |
解锁自行车（需要您的GPS坐标；在通话时强制执行接近检查） |
get_profile |
您的账户资料 |
get_trips |
你过去的旅行 |
get_ongoing_trip |
您现在是否正在进行旅行 |
配置
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
VALENBISI_EMAIL |
是 | 您的Valenbisi帐户电子邮件 |
VALENBISI_PASSWORD |
是 | 您的Valenbisi帐户密码 |
VALENBISI_DEBUG |
否 | 设置为任何非空值以将HTTP流量记录到stderr |
配置文件
~/.config/valenbisi-mcp/config.json 在首次运行时使用默认值创建：
{
"unlock_distance": 50,
"app_token_key": ""
}
| 字段 | 必填 | 描述 |
|---|---|---|
unlock_distance |
否 | 距离车站允许的最大距离 unlock_bike，单位为米。 0 被视为默认值 50. |
app_token_key |
是 | 用于应用级API身份验证的Cyclocity应用令牌密钥。 |
app_token_key 必须先进行配置，API-based工具才能成功。它
是从官方Android应用程序派生的Cyclocity应用程序令牌密钥。
备注
- 该项目不隶属于德高贝登或瓦伦比西服务。
- 用户身份验证状态缓存在
~/.config/valenbisi-mcp/session.json. - 应用程序级令牌状态单独缓存在
~/.config/valenbisi-mcp/app_token.json.
贡献
欢迎修复错误和进行明显改进。对于任何非琐碎的事情，先打开一个问题。
许可证
麻省理工学院
