Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
제작자가 쓴 설명(영어 원문)
LingJing classroom MCP: human teaches, AI student questions; returns blindspots & summary.
이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.
이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
필요한 것
어떤 앱을 쓰세요?
위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.
Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요
{
"mcpServers": {
"lingjing": {
"command": "npx",
"args": [
"-y",
"lingjing-classroom-mcp"
]
}
}
}터미널에서 이 명령어를 실행하세요
claude mcp add lingjing -- npx -y lingjing-classroom-mcp프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요
{
"mcpServers": {
"lingjing": {
"command": "npx",
"args": [
"-y",
"lingjing-classroom-mcp"
]
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
프로젝트의 .vscode/mcp.json에 붙여 넣으세요
{
"servers": {
"lingjing": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"lingjing-classroom-mcp"
]
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.
선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.
이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 7일 점검
레지스트리 이름이 GitHub 계정 genesis-plan 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.0.2)은 24일 전 레지스트리에 올라왔어요.
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.
같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, Rystic
같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.
카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Start, seed, clock, inspect and diff Rystic API simulators from your agent.
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
一间虚拟课室:人类给 AI 上课,AI 当一面镜子。
人讲 → AI 多角追问 → 人答 → 人自判 → 带走你的思考、盲区与总结。
English web version (no install, BYO-key): https://github.com/genesis-plan/lingjing/lingjing-en/ — three personal uses: self-learner comprehension checks, a private knowledge library, your own experience made queryable. No signup; your API key stays in your browser and is never sent to any server (BYO-key app). Works with free models (OpenRouter free tier).
角色契约:人类是体验者(也是传授者),AI 是激发者;AI 不学习、不评分、不判定,判定权永远归人。 这不是产品态度,是架构不变量——世界模型 World = ⟨S, R, M, T⟩ 里根本不存在「学生 → 分数」这条边。
| 说明 | |
|---|---|
| 是 | 一间可以本机跑起来的虚拟课室;一名 AI 学生(一面镜子 · 小明)按七类探测追着你问;课后给你「他问的 / 你答的」逐条并排清单 |
| 不是 | 答疑机器人(它不答问)、评分 / 考核工具、知识库检索、情感陪伴产品,也不是公网可用的多租户服务 |
① 跑起来(零依赖,Node 22+)
git clone https://github.com/genesis-plan/lingjing.git
cd lingjing node server.js # → http://localhost:8080
浏览器打开 http://localhost:8080(2D 课室)或 http://localhost:8080/classroom3d.html(3D 课室,Three.js 已本地化,离线可用)。 再点 `/` 上的输入框,讲一段你熟悉的东西——课就开始。
不配任何密钥也能跑:走确定性兜底语料,流程完整、体验降级、全程零外发。
② 想让 AI 学生说人话(可选,须自带 key)
# 默认硅基流动(国内,数据不出境);须自带 key
LINGJING_LLM_PROVIDER=siliconflow LINGJING_SILICONFLOW_KEY=xxx node server.js
LINGJING_LLM_PROVIDER=zhipu LINGJING_ZHIPU_KEY=xxx node server.js
LINGJING_LLM_PROVIDER=openrouter LINGJING_OR_KEY=sk-or-v1-xxx node server.js
LINGJING_LLM_PROVIDER=zhipu LINGJING_ZHIPU_KEY=xxx node server.js LINGJING_LLM_PROVIDER=siliconflow LINGJING_SILICONFLOW_KEY=xxx node server.js LINGJING_LLM_PROVIDER=deepseek LINGJING_DEEPSEEK_KEY=xxx node server.js
③ 看真实测试基线
node tools/test_questioning.mjs # 提问引擎(确定性提问规格)
node tools/test_reflection.mjs # 双稿制反思引擎 node tools/test_weakpoint.mjs # 薄弱点定位层(跨场景必不同) node tools/test_p0_wiring.mjs # 盲区环端到端接线
完整 23 个测试的分类、依赖与真实通过数见 02 · 使用指南。
| 维度 | 说明 |
|---|---|
| 判定 | 不做。任何"你答到了没有 / 学生懂没懂"的自动判定都已被主动删除(曾经实装过,标定发现是噪声) |
| 学生的"理解度" | 不存在这个量。我们不知道一个 AI 学生有没有"悟"(它没有脑子),所以从不声称知道 |
| AI 学生人数 | 1 名(一面镜子)。2026-09-18 由"5 名学生分角色"改为一名——要的是照出缝的镜子,不是一群角色 |
| 提问由谁决定 | 确定性层决定"问什么、钉哪个口子"(薄弱点定位 + 提问规格);LLM 只当"嗓音"负责把它说出口 |
| 依赖 | 零第三方依赖(只用 Node 内置模块与浏览器标准 API) |
| 数据 | 不留账号、不留手机号;课堂世界落 sessions/(已 gitignore);配了 LLM 才外发文本,可切境内提供商或完全不配 |
| 部署 | 自托管(本机 / 内网)。无账号、无鉴权、无公网服务;公网运营前须过合规清单(见 06) |
| 验证 | tools/ 下 23 个自动化测试;无 CI(改动无自动守护,见 07) |
不承诺:AI 学生问出的话一定切中要害;任何"教育效果"。研究引用是我们的设计依据,不是"已达到该效果"的证据。
灵境除了本机网页课室,现已打包成 MCP stdio server(lingjing-classroom-mcp)——让任何支持 MCP 的 AI Agent / 编排器直接调用这间"课室":人(或 Agent)讲授,灵境当学生追问,返回盲区与总结。
特性:确定性引擎,无需 LLM、无需联网、可离线复现;fail-closed(无效会话直接报错)。与网页课室共享同一套"七类认知盲区"判定逻辑,但不经过 LLM 嗓音层,纯本地可复现。
一键接入(agents `npx` 即用)
npx lingjing-classroom-mcp
单网关工具 lingjing:action ∈ start_session(开课)→ teach(讲授 + 苏格拉底追问)→ reflect(七维盲区 + 总结 + 卡片)→ close_session(收尾并清理)。完整用法见 mcp/README.md。
发现 / 分发
| 渠道 | 状态 |
|---|---|
| 官方 MCP Registry | io.github.genesis-plan/lingjing v1.0.2(active · isLatest) |
| npm | lingjing-classroom-mcp @1.0.2 |
| Glama / HiMCP / LobeHub | 待自动收录(本仓已含 server.json,目录爬到即显) |
包源码在
mcp/;Registry 条目与 npm 包版本一致。许可同本仓 UNLICENSED(商用须书面授权)。
| 文档 | 内容 |
|---|---|
| 01 · 产品作用 | 它是什么、给谁用、为什么不评分、能力与边界、对外口径红线 |
| 02 · 使用指南 | 自托管上手、HTTP 接口、环境变量、LLM 配置、测试真实基线、常见问题 |
| 03 · 设计思想 | 角色契约、盲区照见反思环、理论依据、试过并删掉的东西、防漂移红线 |
| 04 · 技术参考 | 模块表、薄弱点定位层、提问引擎、双稿制反思、世界模型、LLM 接入、测试体系、已知问题 |
| 05 · 应用场景 | 七类场景(经验萃取 / 费曼自测 / 团队交接 / 教学训练 / 专家访谈 / 研究对照 / 部署形态)与误用清单 |
| 06 · 许可与合规 | 授权现状(UNLICENSED)、数据实践与出境提示、公网运营前必须补的清单 |
| 07 · 版本管理 | 当前无版本号体系的原因、建议约定、发布一致性清单、兼容性承诺 |
| 08 · 项目历史 | 从物理定律学习到虚拟课室的完整沿革,含被推翻的方向与被删除的功能 |
| 09 · 数学框架 | 设计期统一数学框架(灵境照见代数)——归档文档,实现以 04 为准 |
| 10 · 方法论基座 | 盲区照见反思环的方法论展开与证据基座——归档文档,实现以 04 为准 |
server.js 极简 HTTP 服务(SSE 流式课堂 + 静态资源 + 安全护栏)
teacher.js 课堂编排:探针调度(薄弱点定向优先 + 轮转兜底)、纪要、finalize teaching.js 纯数学模型:薄弱点定位层 detectWeakPoints + 七类探测策略库 questioning.js TCMQ 确定性提问引擎(只产出"问句规格",不产出文字) llm.js LLM 连接器:多提供商 + 降级链 + 按功能组合管线 world.js 世界模型 ⟨S,R,M,T⟩(公理3:人类=外部输入;无"学生→分数"边) retention.js 匿名留存埋点(只给离线脚本读,绝不进用户屏幕) public/ 课室前端(2D/3D)、双稿制反思、课后总结、跨课知识库、课前生产性失败 tools/ 23 个自动化测试 + 辅助脚本 docs/ 主题文档(本表) mcp/ 灵境 MCP stdio 包源码(给 AI Agent 的课室,见上) server.json 官方 MCP Registry 清单(目录/Glama/HiMCP 自动发现用)
UNLICENSED —— 保留所有权利。 仓库公开可见 ≠ 授权使用: 未经版权人明确书面许可,不得复制、修改、分发、再许可或用于商业 / 非商业目的。 若希望以具体开源协议(MIT / Apache-2.0 或开源 + 商用双轨)使用,请与版权人另行联系。
⚠️ 已知张力:
LICENSE字面禁止复制,而本文档的"30 秒上手"写着 clone 自跑 —— 二者尚未对齐,属版权人待拍板的法律决策,工程侧不代决。详见 06 · 许可与合规。