返回 MCP 目录
public公开dns本地运行

campus-assistant

基于MCP的校园移动服务平台,提供通讯、成绩查询和备忘录等学生服务

article

README

🚀 校园助手 - Campus Assistant

校园助手是一个基于小智 MCP (Mobile Communication Protocol) 构建的综合性平台,通过移动设备(小智终端)为学生提供便捷的校园服务,如通讯交流、成绩查询以及备忘录设置等,满足学生校园生活的多种需求。目前项目处于初创阶段,欢迎大家参与改善。

🚀 快速开始

  1. 启动 MCP 服务
    uvicorn app:app --reload
    
  2. 启动前端服务
    cd web
    npm run dev
    
  3. 启动原生壳
    cd mobile
    npx cap open android
    
  4. 打包安卓端
    cd web;npx cap sync android
    npm run build --prefix web
    

✨ 主要特性

  • 通讯功能:学生可以通过小智终端进行相互沟通。
  • 成绩查询:学生可以方便地查询自己的各科成绩。
  • 备忘录设置:学生可以为重要事项设置个人备忘录和提醒。

📚 详细文档

目录结构

| 目录 | 详情 | |------|------| | mcp/ | MCP 接口服务(FastAPI) | | backend/ | 后台路由与业务逻辑(可独立) | | web/ | Web 前端(React/Vue + Vite) | | mobile/ | Capacitor 打包生成的原生壳 | | shared/ | 公共模型、类型定义 | | docs/ | 项目文档、接口规范、ER 图 |

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端