课表查询服务

hdu-course-mcp-server

基于 fastmcp 框架的杭州电子科技大学课表 MCP Server。

项目结构

hdu-course-mcp-server/
├── server.py                    # 主服务入口，基于 fastmcp 框架
├── fetch_schedule.py            # 异步请求处理模块
├── config.py                    # 配置文件读取与 curl 解析
├── jiekou.txt                   # 课表接口 curl 命令（需自行提供）
├── kb.json                      # 保存的课表数据（自动生成）
├── claude_desktop_config.json   # Claude Desktop 配置文件
└── README.md                    # 项目说明文档

安装方法

1. 安装 Python 3.8+。
2. 安装依赖：
   复制

   pip install fastmcp aiohttp aiofiles
   

3. 在项目根目录放置 jiekou.txt，内容为完整的 curl 命令。

使用方式

1. 启动服务：
   复制

   python server.py
   

2. 服务启动后会自动读取 jiekou.txt，请求课表并保存为 kb.json。

工具接口说明

• get_course_schedule：异步获取课表信息，返回 JSON 格式的课表数据。
• 支持自动缓存到 kb.json 文件。
• 可扩展更多工具，直接在 server.py 中添加新的 @mcp.tool 装饰器函数。

如何连接 Claude for Desktop

1. 在 Claude for Desktop 工具管理中添加 MCP Server，填写本服务地址。
2. Claude 可通过 MCP 协议调用 get_course_schedule 工具。

扩展说明

• 可在 server.py 中添加更多 MCP 工具（如成绩查询、考试安排等）。
• 按需扩展 fetch_schedule.py、config.py 实现更多功能。
• 所有网络请求均使用异步方式，提高性能。

维护与开发建议

• 代码注释清晰，便于理解和扩展。
• 推荐模块化开发，便于后续维护。