SG

sjtu-geek/sjtu-mcp-server

部署与 DevOps官方
20 stars 5 forks 质量 55 趋势 23GPL-3.0

展开项目背景 当前大语言模型领域正经历着关键的技术范式转型:一方面,,传统依赖数据规模与算力堆叠的路径已触及瓶颈。OpenAI联合创始人Ilya Sutskever指出,预训练时代的数据增长接近天花板,GPT系列模型的性能提升幅度明显减小,投入与回报的失衡迫使行业探索新方向。另一方面,,推理成本大幅下降至“白菜价”,从“不够用”演变为“急需落地”,2025年被视为AI应用爆发的元年。

概览

展开项目背景 当前大语言模型领域正经历着关键的技术范式转型:一方面,,传统依赖数据规模与算力堆叠的路径已触及瓶颈。OpenAI联合创始人Ilya Sutskever指出,预训练时代的数据增长接近天花板,GPT系列模型的性能提升幅度明显减小,投入与回报的失衡迫使行业探索新方向。另一方面,,推理成本大幅下降至“白菜价”,从“不够用”演变为“急需落地”,2025年被视为AI应用爆发的元年。 在此背景下,,其通过任务拆解、工具调用与自主决策的能力,将大模型从“对话工具”升级为“生产力引擎”,被视为通往AGI的必经之路。而**,则为Agent生态提供了关键基础设施。作为开源的标准化交互协议,MCP统一了大模型与外部工具、数据源的连接方式,解决了传统Function Call的碎片化问题,被类比为“AI领域的HTTP协议”。阿里云、OpenAI等巨头已全面集成MCP,其生态正以指数级扩张,成为Agent开发的事实标准。 在此趋势下,本项目**,通过标准化接口将大模型与校园信息系统(如课表查询、图书馆预约、成绩分析等)深度对接,用户仅需自然语言指令即可完成复杂操作。这一设计将分散的校园服务整合为统一的AI交互入口,既保障了数据安全与本地化部署需求,又通过MCP的开放性降低了开发门槛,为大模型在教育场景的落地提供了轻量化解决方案。 1. 在 Github Releases 下载最新版的程序,解压后,复制其中可执行文件(Windows 下为 SJTUGeek.MCP.Server.exe)的** 2. (推荐)完成 jAccount 授权以便使用仅登录后可用的工具,具体方式请参考 Authorization。 3. (推荐)安装 Python 环境,并安装依赖库 4. 在 Cherry Studio 等支持 MCP 服务器的客户端中添加服务器 - ,“命令”填写**,“参数”, - 若要启用 Python 插件,则需要加上 --pydll 参数,Windows 系统需要加上后缀 .dll,例如 python310.dll - 若要访问仅登录后可用的工具,则必须加上 --cookie 参数 - 若使用 SSE 形式,则启动 SJTUGeek.MCP.

README

Background

Quick Start

  1. 在 Github Releases 下载最新版的程序,解压后,复制其中可执行文件(Windows 下为 SJTUGeek.MCP.Server.exe)的完整路径
  2. (推荐)完成 jAccount 授权以便使用仅登录后可用的工具,具体方式请参考 Authorization。
  3. (推荐)安装 Python 环境,并安装依赖库
pip install -r requirements.txt
  1. 在 Cherry Studio 等支持 MCP 服务器的客户端中添加服务器
  • 推荐使用 stdio 形式,“命令”填写程序完整路径,“参数”一行一个,不要加双引号
    • 若要启用 Python 插件,则需要加上 --pydll 参数,Windows 系统需要加上后缀 .dll,例如 python310.dll
    • 若要访问仅登录后可用的工具,则必须加上 --cookie 参数
  • 若使用 SSE 形式,则启动 SJTUGeek.MCP.Server 程序时需要加上 --use-http 参数,还有 --cookie=,然后在客户端填写地址为 http://localhost:5173/sse
  • 若使用 Streamable HTTP 形式,则启动 SJTUGeek.MCP.Server 程序时需要加上 --use-http 参数,还有 --cookie=,然后在客户端填写地址为http://localhost:5173/
  1. 启用 MCP 服务器,和 LLM 对话,例如:

Tool Intergration

网站 工具列表 实现方法
教学信息服务网 https://i.sjtu.edu.cn/ 个人课表 (personal_course_table)课程成绩 (personal_course_score)学积分排名 (personal_gpa_and_ranking)考试信息 (personal_exam_info) 原生
交大邮箱 https://mail.sjtu.edu.cn/ 邮件列表 (get_personal_mails)邮件详情 (get_mail)标记邮件已读 (mark_mail)发送邮件 (send_mail) 原生
场馆预约 https://sports.sjtu.edu.cn/pc/ 预约场馆 (book_venue)获取场馆信息 (get_venue_info)获取场地图 (get_field_availability_map)列出个人订单 (get_venue_orders)取消订单 (cancel_venue_order) 原生
四则运算 (测试功能) 加法 (add)减法 (subtract)乘法 (multiply)除法 (divide) Python 插件
个人信息 https://my.sjtu.edu.cn/ 基本账户信息 (account_info) Python 插件
第二课堂 https://activity.sjtu.edu.cn/ 列出最新活动 (sjtu_activity)报名活动 (sjtu_activity_signup) Python 插件
教务处 https://jwc.sjtu.edu.cn/ 列出面向学生的通知公告 (jwc_news) Python 插件
交大新闻网 https://news.sjtu.edu.cn/ 列出最新的交大新闻 (sjtu_news) Python 插件

*注:通过 Python 插件实现的工具需要 Python 环境才可以运行

Authorization

  1. 打开 https://my.sjtu.edu.cn/ 并登录
  2. 然后在同一浏览器窗口内打开 https://jaccount.sjtu.edu.cn/jaccount/
  3. 按下 F12 打开开发者工具(部分浏览器也可以使用 Ctrl+Shift+I),在“应用程序——存储——Cookie”里面可以看到 JAAuthCookie

  1. 复制这一串内容,作为 SJTUGeek.MCP.Server 启动时的 --cookie 参数值

Roadmap

  • [ ] 支持 JS 脚本
  • [x] 优化参数以及返回值类型判断
  • [x] 命令行参数解析
    • [x] 禁用 Python/JS
    • [x] 工具分组控制
  • [x] 脚本环境赋能
    • [x] jAccount 凭据
    • [x] 内存缓存
    • [ ] 数据库KV存储
  • [ ] 日志系统

Contribution Guide

  • 为了方便开箱即用,MCP 工具首选使用 C# 语言实现(本仓库)
  • 如果不会 C#,也可以写 Python,在 contrib 子仓库
  • 若用 Python 开发,请把 JAAuthCookie 添加到环境变量,方便调试

Contact

欢迎加入上海交通大学学生信息技术协会(思源极客协会),和我们一起探索数智校园的无限可能!

协会官网:https://geek.sjtu.edu.cn/ 招新问卷:https://ssc.sjtu.edu.cn/f/fdd3762e

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →