跳转至

快速开始

需要 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。