Campus Copilot MCP

@campus-copilot/mcp-server

用于本地 CampusCopilot BFF 和导入的工作区快照的只读 MCP 服务。

这是 examples/integrations/ 下集成示例使用的通用 MCP 入口。

如果你想为 Codex / Claude Code 风格的本地 MCP 工作流选择最精简的单服务入口，请使用此软件包。

如果你还在通用 MCP 服务、站点 sidecar、CLI 或 SDK 接口之间犹豫，请先查看 ../../examples/toolbox-chooser.md。

安装

当前安装状态：仓库本地的公开接口，附带打包好的 JS 服务产物。官方 MCP Registry 流程现在使用托管在 GitHub Release 上的 .mcpb 包来发布此服务；从发现页面回读仍是单独的验证步骤。

在仓库根目录运行：

pnpm install
pnpm --filter @campus-copilot/mcp-server build
pnpm start:mcp

在仓库根目录执行的通用公开预览验证流程：

pnpm proof:public

首先尝试运行的命令：

pnpm --filter @campus-copilot/mcp-server start

此仓库中解除 Registry 阻塞的进展：

• 已发布的可执行文件现在指向打包好的 dist/bin.mjs 产物，而不是原始 TypeScript 入口文件
• Registry 发布流程现在提供托管在 Release 上的 .mcpb 包，不再依赖并不存在的公开 npm scope
• 预注册元数据现在与软件包一同存放于 server.json，软件包级别的 mcpName 也在其中
• 包清单现在存放于 mcpb.manifest.json
• 仓库侧可直接用于提交的字段现在也存放于 registry-submission.packet.json
• 公开分发路由存放于 ../../DISTRIBUTION.md
• 从 Registry 发现页面回读仍是单独的上游步骤；此 README 并未表示列表界面已经重新读取

在仓库根目录进行 Registry 预检验证：

pnpm check:mcp-registry-preflight

此预检会检查容易在后期偏离的对齐项：

• package.json#mcpName
• server.json 中的 Release 资源 URL / SHA / 传输方式对齐情况
• mcpb.manifest.json 的版本和入口点对齐情况
• monorepo 的 subfolder 路径
• 示例配置及准确的安装说明
• 供所有者后续重复使用的仓库自有提交数据包

相关的公开分发文档：

• ../../DISTRIBUTION.md

搭配容器路径使用

当前的 Docker 接口有意设计为精简的本地 BFF，而不是此 stdio 服务本身。

这种区分是有意为之：

• stdio MCP 服务仍是本地只读 MCP 入口
• Docker 路径为仓库提供真实可信的 HTTP 和健康检查接口
• 二者结合，确保产品以本地优先为原则，而不是假装 CampusCopilot 是托管的 MCP 服务

在仓库根目录构建容器化 BFF：

docker build -t campus-copilot-api:local .
docker compose up -d campus-copilot-api

需要本地 HTTP 接口或适用于容器的健康检查时，请使用容器路径。 需要本地 stdio MCP 服务时，请继续使用此软件包。 如果要用一句话概括：将其与本地 stdio MCP 服务搭配使用，并将 Docker 路径视为本地 HTTP 辅助接口，而非托管 API。

你也可以不使用 Compose，直接启动本地容器：

docker run --rm -p 8787:8787 campus-copilot-api:local

当前工具

• campus_health
• providers_status
• ask_campus-copilot
• canvas_snapshot_view
• gradescope_snapshot_view
• edstem_snapshot_view
• myuw_snapshot_view
• export_snapshot_artifact

边界

• 本地优先
• 只读
• stdio
• 以快照或精简 BFF 为先
• 不是托管的 MCP 服务
• 不是托管 API
• 不是实时浏览器控制平面
• 不是校园网站的修改接口
• 不是注册自动化接口
• 不是原始课程文件的 AI 上传接口

此处与其他所有地方遵循相同的学术安全规范：

• ../../docs/07-security-privacy-compliance.md

See also

• ../../examples/toolbox-chooser.md
• ../../examples/integrations/README.md
• ../../examples/integrations/codex-mcp.example.json
• ../../examples/integrations/codex-mcp-shell.example.json
• ../../examples/integrations/claude-code-mcp.example.json
• ../../examples/integrations/claude-code-mcp-shell.example.json
• ../../examples/openclaw-readonly.md