psc_mpc 0.0.3

普通话水平测试报名查询工具

PSC MCP 服务器

基于 FastMCP 框架开发的普通话水平测试（PSC）考试报名查询系统，提供全国各省份测试站点的报名信息查询服务。

目录

• 功能特性
• 安装
• 作为包使用
• 作为Web服务运行
  • 本地运行
  • Docker 部署
• API 接口
• 项目结构
• 许可证

功能特性

• 🌍 省份列表获取 - 获取支持的所有省份列表
• 📅 报名信息查询 - 实时查询各省份开放报名的测试站点
• ⏱️ 即将开考查询 - 查看即将举行考试的测试站点信息
• 🚀 高性能架构 - 基于 FastMCP 框架，提供高效的 API 服务
• 🐳 容器化部署 - 支持 Docker 快速部署

安装

作为包安装

pip install psc-mpc

开发环境安装

推荐使用 uv 管理依赖：

uv sync

或者使用 pip 安装依赖：

pip install -r requirements.txt

作为包使用

安装后，您可以直接在 Python 代码中使用该包：

from psc_mpc import get_provinces, get_open_stations, get_next_stations

# 获取省份列表
provinces = get_provinces()
print(provinces)

# 获取宁夏开放报名的测试站点
ningxia_stations = get_open_stations("ningxia")
print(ningxia_stations)

# 获取宁夏即将开考的测试站点
next_stations = get_next_stations("ningxia")
print(next_stations)

作为Web服务运行

本地运行

启动开发服务器：

uv run python src/psc.py

或者使用 Python 直接运行：

python -m src.psc

服务器将在 http://localhost:8000 启动。

Docker 部署

构建 Docker 镜像：

docker build -t psc-mpc .

运行容器：

docker run -p 8000:8000 psc-mpc

API 接口

方法	路径	描述
GET	/provinces	获取省份列表
GET	/open-stations/{province_id}	获取指定省份开放报名的测试站点
GET	/next-stations/{province_id}	获取指定省份即将开考的测试站点

示例请求

1. 获取省份列表：

   curl http://localhost:8000/provinces
   

2. 查询宁夏开放报名的测试站点：

   curl http://localhost:8000/open-stations/ningxia
   

3. 查询宁夏即将开考的测试站点：

   curl http://localhost:8000/next-stations/ningxia
   

项目结构

psc_mpc/
├── src/
│   ├── __init__.py
│   └── psc.py          # 主应用文件
├── Dockerfile          # Docker 配置文件
├── pyproject.toml      # 项目配置和依赖声明
├── README.md           # 项目说明文档
├── requirements.txt    # 依赖列表
└── uv.lock             # 依赖锁定文件

许可证

本项目采用 MIT 许可证。详情请见 LICENSE 文件。