Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client