浏览器登录（CAS+MFA）→ 保存 jw_session.json → MCP Server 启动 → AI 客户端连接
                                                      ↓
                                               15 个工具可用
                                             6 查询 + 4 分析 + 4 信息 + 1 登录
                                             适配正方 V-9.0 接口

# 从 PyPI 安装（推荐）
pip install gdmu-mcp

# 或从源码安装
git clone https://github.com/S4saK1/gdmu_mcp.git
cd gdmu_mcp
pip install -e .

# 自动打开 Chrome，完成 CAS 认证（含 MFA）
# 登录成功后自动保存 Cookie 到 jw_session.json
python browser_login.py

# 标准启动
python server.py

# 指定调试模式
GDMU_DEBUG=1 python server.py

{
  "mcpServers": {
    "gdmu-mcp": {
      "command": "python",
      "args": ["path/to/gdmu_mcp/server.py"],
      "env": {
        "GDMU_JW_BASE": "https://jw.gdmu.edu.cn",
        "GDMU_AUTH_BASE": "https://authserver.gdmu.edu.cn"
      }
    }
  }
}

pip install gdmu-mcp
python -m gdmu_mcp

docker build -t gdmu-mcp .
docker run -v ./jw_session.json:/app/jw_session.json gdmu-mcp

git clone https://github.com/S4saK1/gdmu_mcp.git
cd gdmu_mcp
pip install -e .
python server.py

# 克隆 + 安装开发依赖
git clone https://github.com/S4saK1/gdmu_mcp.git
cd gdmu_mcp
pip install -e ".[dev]"
playwright install chromium

# 运行测试
pytest

# 代码检查
ruff check .
mypy server.py browser_login.py

gdmu_mcp/
├── server.py               # MCP Server 入口
├── browser_login.py        # 浏览器辅助登录（CAS + MFA）
├── Dockerfile              # 容器化部署
├── config.example.env      # 环境变量模板
├── requirements.txt        # 依赖清单
├── pyproject.toml          # 包配置（支持 pip install gdmu-mcp）
├── CHANGELOG.md            # 更新日志
├── CONTRIBUTING.md         # 贡献指南
├── LICENSE                 # MIT 许可证
├── README.md               # 本文件
├── tests/                  # 测试目录
│   ├── __init__.py
│   ├── conftest.py
│   └── test_smoke.py       # 18 个测试用例（3 基础 + 15 mcp/gdmu_agent 跳过）
├── gdmu_mcp/               # 包目录（python -m gdmu_mcp 入口）
│   ├── __init__.py
│   ├── __main__.py
│   └── server.py           # 转发到根目录 server.py
└── .github/
    └── workflows/
        ├── pytest.yml      # CI — 测试
        └── publish.yml     # PyPI 自动发布