我的J MCP服务器
大波士顿JCC(Leventhal Sidman JCC)移动应用程序的MCP服务器,通过逆向工程构建 uPace 平台API从安卓APK(com.upace.erjcc).
特性
24个工具,涵盖移动应用程序中的所有可用内容:
课程与活动 --列表、预订、取消、收藏、搜索 设备 --保姆(JCare)、私人办公室、泡菜球场 预约 --个人训练、篮球课、游泳课 等候名单 --查看职位、加入、离开 预订 --查看您自己和家人的预订 信息 --设施详细信息、警报、其他程序、视频内容、反馈
安装并运行
来自GitHub(推荐)
uvx --from git+https://github.com/aserper/myj-mcp.git myj-mcp本地开发
git clone https://github.com/aserper/myj-mcp.git
cd myj-mcp
uv venv && uv pip install -e .
python -m myj_mcp码头工人
docker run --rm -e UPACE_EMAIL="you@email.com" -e UPACE_PASSWORD="pass" \
ghcr.io/aserper/myj-mcp:latest配置
通过环境变量设置凭据:
export UPACE_EMAIL="your@email.com"
export UPACE_PASSWORD="yourpassword"克劳德代码
{
"mcpServers": {
"myj": {
"command": "uvx",
"args": ["--from", "git+https://github.com/aserper/myj-mcp.git", "myj-mcp"],
"env": {
"UPACE_EMAIL": "your@email.com",
"UPACE_PASSWORD": "yourpassword"
}
}
}
}或者使用Docker:
{
"mcpServers": {
"myj": {
"command": "docker",
"args": ["run", "--rm", "-i", "ghcr.io/aserper/myj-mcp:latest"],
"env": {
"UPACE_EMAIL": "your@email.com",
"UPACE_PASSWORD": "yourpassword"
}
}
}
}工具
| 工具 | 说明 |
|---|---|
login | 使用电子邮件/密码进行身份验证 |
list_classes | 按日期列出类(默认值:今天) |
list_events | 按日期列出事件 |
reserve_class | 预订课程或活动 |
cancel_reservation | 取消预订或离开候补名单 |
my_reservations | 查看当前预订 |
family_reservations | 查看家庭成员预订 |
list_equipment | 列出可预订的设备(保姆、办公室) |
reserve_equipment | 按时间段+持续时间预订设备 |
list_pt_sessions | 列出预约/PT会话类型 |
get_session_times | 获取会话的可用时间 |
book_session | 预约PT/预约会议 |
get_waitlist | 查看候补课程 |
delete_waitlist | 留下候补名单 |
toggle_favorite | 在收藏夹中添加/删除类 |
search | 搜索课程、设备、课程 |
alerts | 查看通知 |
mark_alert_read | 将警报标记为已读 |
facility_info | JCC设施信息 |
user_info | 用户资料信息 |
other_programs | 其他程序和自定义链接 |
video_categories | 视频内容类别 |
video_listings | 按类别列出的视频 |
submit_feedback | 对课程/活动/设备进行评分(1-5) |
测试
uv pip install pytest
pytest tests/ -vAPI
在APK中发现了两个API版本:
- 第1版
https://www.upaceapp.com/Api--表单编码,通过身份验证api_key+uid+user_id - 第2版
https://upace.app/api--JWT代币持有者
看 api-discovery.md 获取完整的端点文档。
项目结构
src/myj_mcp/
├── __init__.py
├── __main__.py # Entry point
├── client.py # UpaceClient — HTTP client with auth
├── models.py # Pydantic models
└── server.py # FastMCP server (24 tools)