beimingda
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
北民大小助手 · beimingda
把散落的校园服务,收进一个对话。
第一届"银移杯"校园 AI Agent 创新大赛 · 赛道一 智慧校园 Agent 创意赛道
队伍 啊对对(TM202610160004)| 站点 https://demo.knowingly.dpdns.org | 提交截止 2026-10-31 23:59:59
四个模块:代取撮合 · 搭子匹配 · 迎新导览 · 日程提醒。
平台能力通过远程 Streamable HTTP MCP(POST /mcp,15 个工具)开放给 WorkBuddy,
评委零配置接入即可用一句话操控整个平台。
一键跑起来(非技术同学看这段)
Windows:双击
启动服务.cmd—— 自动装依赖、建库灌演示数据、起服务、打开浏览器macOS / Linux:
bash start.sh改完代码想确认没坏:双击
自检.cmd(161 项测试 + 8 项冒烟 + 114 项集成校验)
想了解每个文件是干什么的、环境变量有哪些、演示当天要做什么 → 看 交付说明.md。
Related MCP server: Grok Bot MCP Bridge
快速开始(开发同学)
git clone https://github.com/xfjsssq/beimingda.git
cd beimingda
npm install # 网络慢可加 --registry=https://registry.npmmirror.com
cp .env.example .env # Windows: copy .env.example .env
# 编辑 .env:至少填 DEMO_TOKEN(写接口与 /mcp 鉴权用)
npm run seed # 幂等灌演示数据
npm start # http://127.0.0.1:3000自检(一条命令跑完关键验收点):
npm run smoke
npm test常用地址:
地址 | 说明 |
| 健康检查,返回统一信封 |
| MCP 远程端点( |
| 6 个页面 |
| 前端配置注入( |
| ⭐ 脱敏审计,评委核验用(M4) |
技术栈(冻版,不得更换)
层 | 选型 |
前端 | 静态 HTML + 原生 JS(Vue 3 可选,须本地化到 |
地图 | Leaflet + 天地图官方瓦片(不自建底图) |
全景 | Pannellum(MIT) |
后端 | Node.js 20+ / Express / better-sqlite3 |
MCP | 远程 Streamable HTTP |
部署 | Cloudflare 隧道 → |
目录结构
beimingda/
├── src/
│ ├── server.js HTTP 入口与路由注册
│ ├── db/{schema.sql,index.js}
│ ├── engine/ 撮合与匹配评分引擎(M1/M2)
│ ├── services/ 业务层(HTTP API 与 MCP 共用,⛔ 不许各写一份)
│ ├── mcp/{server.js,tools.js,handlers.js}
│ ├── api/routes.js HTTP API 路由
│ ├── middleware/{auth.js,ratelimit.js}
│ └── util/{envelope.js,time.js}
├── static/ 6 个页面 + css/js + vendor(离线可跑)
├── config/ periods.json / map-nodes.json / match-rules.json
├── fixtures/ 全虚构演示数据(demo=1)
├── pano/ 全景图与 multi-scene tour 配置
├── scripts/{seed.js,smoke.js,reminder.js}
├── tests/ node --test 单测
├── docs/ ARCHITECTURE / DB-SCHEMA / MCP-TOOLS
└── contracts/ tasks/ 需求契约与任务卡(与代码同仓冻结)分支与协作(⭐ 先读再动手)
分支 | 负责 | 内容 |
| 共同 | 只接受 PR,不直接推 |
| 骨架 A | T0 骨架 + 建表 + HTTP 路由 + MCP 端点 + 鉴权(已完成) |
| A | 代取撮合(引擎 + MCP 5 工具 + 页面) |
| B | 搭子匹配(画像 + 双选 + MCP 3 工具 + 页面) |
| B | 迎新导览(地图 + 全景,纯前端为主) |
| A | 日程与提醒(含脱敏审计) |
| B | 门户首页 + |
| 共同 | 参赛材料与交付包 |
每个分支根部有
BRANCH.md:写清做什么 / 依赖什么 / 完成标准 / 不能碰什么 / 当前进度commit message 规范:
feat(模块): 描述(例:feat(m1): 实现撮合评分引擎)冲突高发区(改前先在群里说一声):
contracts/、src/db/schema.sql、src/mcp/tools.js、src/api/routes.js详细流程见
CONTRIBUTING.md
合规红线(全局)
全站不收集真实姓名 / 学号 / 手机号 / 身份证 / 学生证照片 / 校园网账号口令;数据库里没有能存这些的字段
不接入、不登录、不抓取学校任何内部系统;业务代码里绝不出现"输入学号 / 校园网密码"
站点没有「上传课表文件」按钮 —— 刻意设计,课表入口只走对话(MCP)
演示数据一律
demo=1,姓名用"同学A/同学B",学号用2025XXXX,页面加?demo=1密钥只从
process.env读,.env与*.db永不入库;参赛材料里令牌一律写<DEMO_TOKEN>
文档索引
你要做的事 | 读这两份 |
看仓库全貌 |
|
动数据库 / HTTP 路由 |
|
代取撮合 |
|
搭子匹配 |
|
迎新导览 |
|
日程与提醒 |
|
页面与 |
|
MCP 工具清单 |
|
建仓与协作流程 |
|
提交给评委的源码包:
git archive --format=zip --prefix=beimingda/ HEAD -o 源码.zip(git archive天然不含.git;导出后核对无.env/*.db/node_modules/.git/)
License
MIT(见 LICENSE)。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote MCP server exposing SMI Aware tools, resources, and skills over Streamable HTTP.
Host any HTTP API as a standard MCP server; auto-distribute to 12+ mainstream agent platforms.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables users to discover campus resources, download and read course files, check supported student portals, and organize tasks, favorites, and study plans through natural language using their own authenticated session in an MCP host.311MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to discover and create agents, durably submit messages with verifiable replies, and search source-linked local memory. Exposes eight authenticated tools with owner-approved OAuth, transcript-backed verification, and explicit control over history import and embedding.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI clients to access a collection of personal university services—email, cloud storage, tables, Git repositories, TeX projects, and SSH hosts—through MCP tools for searching, reading, writing, uploading, downloading, and running commands.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to carry out campus services in natural language — booking venues with CAPTCHA solving, selecting and dropping courses, submitting homework, batch-completing teaching evaluations, checking grades and timetables, and fetching cloud-drive download links — by handling the login, signing, encryption, and WebVPN proxying for 11 separate university subsystems behind 26 MCP tools.2MIT