快速开始¶
需要 Git 和 uv,项目使用 Python 3.12+。以下命令以 Bash 为例,Windows 用户请在 Git Bash 中运行。
1. 安装¶
git clone https://github.com/Sun-sunshine06/bupt-anything.git
cd bupt-anything
uv sync --frozen
uv run bupt-agent doctor
uv 会管理项目虚拟环境,无需手动激活。项目默认使用清华 PyPI 镜像;如需改用官方源,可在自己的副本中执行 uv lock --default-index https://pypi.org/simple,再运行 uv sync --frozen。
2. 配置账号¶
在自己的终端中输入账号和密码,密码输入不会回显:
uv run bupt-agent login --service academic
uv run bupt-agent login --service ucloud
uv run bupt-agent verify
academic:移动教务账号与密码,密码可能与统一认证不同。ucloud:教学云使用的统一认证账号与密码。verify:实际连接服务验证,只输出连接状态。仅使用部分功能时,可只配置对应服务。
Windows 用户也可以双击 configure-account.cmd 完成配置,需要 Git Bash 安装在默认位置。不要将密码写入 MCP 配置、命令参数或聊天消息。
3. 执行第一次查询¶
# 查看课表
uv run bupt-agent call academic.schedule
# 查看教学云待办
uv run bupt-agent call ucloud.todos
# 自动发现消息通知中尚未开始的作业,读取要求、起止时间和附件信息
uv run bupt-agent call ucloud.upcoming_assignments
# 查询沙河第 3、4 节均空闲的教室
uv run bupt-agent call academic.classrooms --args '{"campus":"04","slots":[3,4]}'
CLI 返回结构化 JSON。更多查询见 工具参考,连接问题见 诊断说明。
接入 AI 客户端¶
完成账号配置后,将以下内容加入支持 stdio MCP 的客户端配置。把 C:/path/to/bupt-anything 替换为项目的实际绝对路径;macOS / Linux 使用对应系统路径。
{
"mcpServers": {
"bupt-agent": {
"command": "uv",
"args": [
"--directory",
"C:/path/to/bupt-anything",
"run",
"--frozen",
"bupt-agent-mcp"
]
}
}
}
重新加载客户端后,可让助手调用 system_capabilities 查看工具、调用 system_status 检查账号配置状态。若客户端找不到 uv,将 command 改为它的绝对路径。
本项目提供工具服务,聊天界面与模型由客户端提供。多账号配置和连接细节见 MCP 接入说明,可复制的配置文件见 mcp.example.json。