内容
# gepai-mcp
**GEP-AI 环境教育 수업 설계 MCP 服务器** — 别无其他服务订阅，已使用AI（Claude，Gemini，ChatGPT/Codex）设计环境教育课程。
教育部门·韩国环境保护研究院研究项目开发的GEP-AI平台（[GEP-AI是什么？](#gep-ai是什么)）的核心资产已被重新包装为[MCP（Model Context Protocol）](https://modelcontextprotocol.io)服务器。LLM调用由用户的AI执行，因此**无需运营成本**即可实现可持续结构。
> **设计理念 — "对话"而非"点击"。** GEP-AI的目的不是通过点击按钮一次获取随处可见的资料。教师和AI通过问答交流深化和扩展想法，**根据教师的课堂、学校和社区背景**共同设计符合环境课程。
## GEP-AI是什么？
**GEP-AI**是由教育部·韩国环境保护研究院招标并由国立公州大学产业合作团执行的**基于AI的环境教育课程设计平台**，是研究课题『开发环境教育资源地图和建立基于AI的教师课程设计利用体系』（研究负责人：이재영，2026年2月最终报告）的成果。命名灵感来自UNESCO的"Greening Education Partnership"，具有**Greening Education Partnership with AI（支持环境教育的全球伙伴关系AI）**和**Greening Education Platform with AI（整合环境教育资源支持课程设计的平台）**的双重含义。
### 问题意识 — "资料很多，但不适合我的课堂"
研究团队对各教育厅的环境教育资料进行了全面分析，结果发现资料的格式、构成和分类体系在各教育厅之间存在差异，资料之间几乎无法连接和相互利用，大多数以PDF、HWP等非结构化形式存在，难以搜索和组合。报告中称之为**"资料很多，但像孤岛一样的档案"。** 同时，2022年修订的课程将环境教育（生态转化教育）扩展为**所有学科的成就标准**，这意味着教师需要自行解释和重构其学科中的环境教育元素。教师访谈的结论是GEP-AI的起点："教师们不用这些资料不是因为资料少，而是因为它们与我的课堂不匹配。"
### 设计理念 — "结构由AI提供，意义和判断由教师创造"
- **辅助思考而非替代**: AI不会自动生成标准化的课程计划。它根据教师的条件和背景提供方向和选项的**初稿**，并始终让教师做出最终判断和教育决策（Human-in-the-Loop）。
- **从搜索到意义连接**: 不是简单地积累资料并查找使用的"树状数据库"，而是让成就标准、主题、活动和地方资源以关系网络连接，并让教师在自己的背景下组合和生成**"根茎型数据库"。**
- **支持两种设计**: 对于条件清晰的教师，提供基于条件的设计（输入学科、成就标准、课时 → 课程计划初稿）；对于有想法但不清晰的教师，提供基于对话的设计（通过问题和建议逐步结构化），两者可以在一个设计过程中相互转换。
### 研究原型 → MCP服务器
研究中，这一理念通过HITL多智能体工作流（协调器+提示分析·信息收集·资料搜索·内容生成代理，3阶段教师评审），基于9维本体论的RAG混合搜索，5项质量验证（SMART学习目标，时间分配，轮子正交性，评估-目标正交性，发展阶段适宜性），支持HWPX·DOCX导出功能的网页平台原型实现，并完成了教师试点应用。由于自主LLM调用的成本结构难以实现常态化免费运营，因此核心资产被重新包装为MCP服务器。
| 研究原型（网页平台） | MCP服务器 |
|---|---|
| 自身LLM（Gemini）调用 → 产生运营成本 | **用户AI**（Claude·ChatGPT·Gemini）负责LLM调用 → 运营成本0 |
| HITL多智能体强制质询和评审步骤 | 6种提示强制执行相同原则（"一次一个问题，总结确认后生成"） |
| 本体论RAG混合搜索 | 元数据搜索 + BM25原文全文搜索 + 基于共现的主题探索 |
| Supabase向量数据库 + 云存储 | 所有数据包内嵌 — 无需外部数据库·API密钥 |
## 包含内容
| 资产 | 规模 | 说明 |
|---|---|---|
| 成就标准数据库 | 3,285条 | 2022年修订课程标准小学、初中、高中所有科目成就标准 |
| 环境教育资料目录 | 933条 | 全国12个教育厅资料（教育部资源地图）— 学校阶段、科目、环境主题、SDGs、成就标准映射 |
| **原文文档目录 + 正文文本** | 1,113条 / 22,341块 | 教育厅资料PDF原文文本 — 正文全文搜索（BM25）和文档阅读支持 |
| 学习轮模型 | — | 李在英教授的环境教育学习模型（4阶段+4连接环） |
| 课程设计流程 | — | GEP-AI实际服务中验证的9阶段设计提示 |
所有数据内嵌在软件包中，**无需外部数据库·API密钥**。
### 内置数据库详情
**① 成就标准数据库** (`standards.json`, 3,285条)
- 来源：2022年修订课程标准（教育部公告）
- 构成：小学653条 · 初中580条 · 高中2,052条，160个科目
- 字段：`code`（成就标准代码），`school`（学校阶段），`subject`（科目），`grade`（年级组），`content`（成就标准内容）
**② 环境教育资料目录** (`resources.json`, 933条)
- 来源：教育部资源地图输入数据 — 12个教育厅
- 各教育厅： 경기 254 · 충북 131 · 서울 121 · 광주 98 · 충남 65 · 대전 54 · 제주 49 · 경남 46 · 부산 40 · 인천 38 · 전남 32 · 경북 5
- 学校阶段：小学 518 · 初中 332 · 高中 207 · 幼儿园 13（资料可多重标记）
- 资料类型（上位）：教师教学指南+学生活动表 348 · 学生活动表 138 · 案例汇编 134 · 教师教学指南 125
- 环境主题：生活环境 458 · 地球环境 386 · 自然环境 373 · 环境文化 171 等
- 成就标准链接：838条资料引用2,837条成就标准（①数据库通过代码交叉查询 — `map_standard_to_resources`）
- 字段：`office`，`collection`（资料集），`title`（活动名称），`materialType`，`activityTypes`，`schoolLevels`，`hours`（课时），`subjects`，`competencies`（环境教育能力），`place`，`envTopics`，`sdgs`，`methods`（教学方法），`standards[{code, text}]`
- 资料**原文文件不包含在内** — 以元数据进行搜索、推荐并提供来源（教育厅·资料集名称）。
**③ 原文文档目录 + 正文文本** (`documents.json` 1,113条 + `chunks.jsonl.br` 22,341块)
- 来源：GEP-AI实际服务RAG流水线 — 教育厅资料PDF 1,113篇文档单位AI元数据强化（地区·学校阶段·科目·环境主题·SDGs·能力·教学法·语义关键词）后提取文本块
- 地区：14个（ 경기 249 · 충북 144 · 서울 125 · 광주 98 等，"全国"）
- 正文文本：22,341块（平均686字，brotli压缩 7.7MB内嵌）— `search_fulltext`搜索正文，`get_document_text`继续阅读
- 精选目录（②）与文件名基准 742条自动连接 — 资料详情直接跳转到原文文本
- **原文PDF直接链接**：1,053篇中997篇（95%）连接Google Drive原文文件链接（`fileUrl`）— 点击一次即可查看。剩余为未公开/部分上传资料，通过官方资料库指南替代（个别学校提交的行信息报告60篇因个人信息问题排除）
**④ 学习轮模型** — 李在英教授基于经验学习理论（Kolb）和变革学习理论（Mezirow）的环境教育学习模型。**4阶段**（感官体验 → 反思与发现 → 创作与表达 → 参与与实践）和**4连接环**（探究·内化·分享·社会化）的8个区块循环结构，包含阶段示例活动和课时数推荐配置（`gepai://learning-wheel`资源提供）
## 工具（Tools）
| 工具 | 说明 |
|---|---|
| `search_standards` | 成就标准搜索（关键词·学校阶段·科目·年级组·代码） |
| `search_resources` | 环境教育资料搜索（关键词·学校阶段·科目·环境主题·SDGs·教育厅） |
| `get_resource_detail` | 资料详情 + 链接成就标准全文 + 查找原文指南（sourceGuide） |
| `map_standard_to_resources` | 成就标准代码 → 链接资料列表 |
| `search_fulltext` | **资料原文正文搜索** — 活动方法·实验步骤·案例直接在PDF原文文本中搜索（BM25） |
| `get_document_text` | 原文文档阅读 — 搜索到的文档正文按块继续阅读 |
| `explore_topics` | 环境主题地图探索 — 主题资料数量、相关主题·SDGs·成就标准·关键词（发现未知资料） |
| `related_resources` | 相似资料推荐 — 共享成就标准·主题·科目为依据 |
## 提示（Prompts）
| 提示 | 说明 |
|---|---|
| `design_lesson` | 基于学习轮模型的课程设计整体流程（信息收集 → 成就标准 → 资料 → 教学指南 → 评估 → 活动表） |
| `context_interview` | **防止一次性点击** — 课程意图·学生背景·教室/学校/社区背景·评估证据·预期误解一次一个问题 |
| `local_pbl_coach` | 学校·社区实际环境问题为基础的项目学习（PBL）设计 — driving question, 学生角色·实际听众, 过程评估 |
| `reflect_lesson` | 课程实施后基于证据的反思 — 反证可能的假设诊断，下节课最小修改方案（学习轮的下一个循环） |
| `lesson_brief` | 设计对话整理成一页简介（未确定标记，同行分享·下一个AI工作交接用） |
| `learning_wheel_guide` | 学习轮模型说明 |
`context_interview`，`local_pbl_coach`，`reflect_lesson`，`lesson_brief`是同一作者的教师技能包[k-teacher-skills](https://github.com/pblsketch/k-teacher-skills)的验证的访谈·设计方法论移植到环境教育。
## 安装
> 🧑🏫 **第一次使用？** 按屏幕顺序操作的[简易安装指南（docs/INSTALL.md）](docs/INSTALL.md)查看。无需安装，直接URL注册的方法到平台详细流程、问题解决。
本地安装需要Node.js 18以上。（安装困难可参考下方[远程MCP](#远程MCP--无需安装-URL注册-教师推荐)）
### Claude Code
```bash
claude mcp add gepai -- npx -y gepai-mcp
```
### Claude Desktop
**设置 → 开发人员（Developer）→ 编辑配置（Edit Config）** 打开`claude_desktop_config.json`（Windows: `%APPDATA%\Claude\`，macOS: `~/Library/Application Support/Claude/`），添加后重启：
```json
{
"mcpServers": {
"gepai": {
"command": "npx",
"args": ["-y", "gepai-mcp"]
}
}
}
```
### Gemini CLI
`~/.gemini/settings.json`添加：
```json
{
"mcpServers": {
"gepai": {
"command": "npx",
"args": ["-y", "gepai-mcp"]
}
}
}
```
### Codex（CLI · IDE扩展 · 桌面应用）
终端输入一行：
```bash
codex mcp add gepai -- npx -y gepai-mcp
```
或在`~/.codex/config.toml`添加（IDE扩展： ⚙菜单 → **MCP settings → Open config.toml**）。CLI · IDE扩展 · 桌面应用（Windows · macOS）都共享此配置文件：
```toml
[mcp_servers.gepai]
command = "npx"
args = ["-y", "gepai-mcp"]
```
确认：`codex`执行后 `/mcp`。
### Cursor
全局`~/.cursor/mcp.json`或项目`.cursor/mcp.json`添加（Cursor Settings → MCP → **Add new MCP Server** UI也支持）：
```json
{
"mcpServers": {
"gepai": {
"command": "npx",
"args": ["-y", "gepai-mcp"]
}
}
}
```
### Google Antigravity（CLI · IDE）
Antigravity产品线集成MCP设置文件，CLI和IDE共享：`~/.gemini/config/mcp_config.json`
```json
{
"mcpServers": {
"gepai": {
"command": "npx",
"args": ["-y", "gepai-mcp"]
}
}
```
- **IDE**: 代理侧面板顶部 **"…" → MCP Servers → Manage MCP Servers → View raw config** 编辑相同文件。（Antigravity 2.0： **Settings → Customizations → Installed MCP Servers → Add MCP**）
- 项目级别使用，请在存储库根目录放置`.agents/mcp_config.json`。提示框中 `/mcp`可查看服务器状态·连接日志。
> 上面没有的工具支持MCP也支持相同格式（`command: npx`，`args: [-y, gepai-mcp]`）注册。
## 使用示例
安装后对AI说：
- "设计一个小学5年级气候变化4节课（或`design_lesson`提示）"
- "中学科学中查找与生态系统相关的成就标准"
- "塑料主题可用教育厅资料有哪些？"
- "[6和05-03] 成就标准与链接资料显示"
## 远程MCP — 无需安装URL注册（教师推荐）
Node.js安装困难时，可使用公共服务器URL：
**`https://gepai-mcp.vercel.app`**
| 平台 | 注册方法 |
|---|---|
| Claude（Web · 桌面） | 设置 → 连接器 → **添加自定义连接器 → 上述URL输入 |
| ChatGPT | 设置 → 连接器（开发模式） → 新连接器 → 上述URL |
| Codex（CLI · IDE · 桌面应用） | `~/.codex/config.toml` `[mcp_servers.gepai]` + `[mcp_servers.gepai]` → 所有Codex产品线共享此文件 |
| Gemini CLI | `~/.gemini/settings.json`的mcpServers中 `"gepai": { "httpUrl": "https://gepai-mcp.vercel.app" }` |
| Google Antigravity | `~/.gemini/config/mcp_config.json`中 `"gepai": { "serverUrl": "https://gepai-mcp.vercel.app" }` — 键名注意：不支持`url`·`httpUrl`
搜索仅执行LLM调用，不调用LLM免费运营。
### 直接托管
```bash
npx gepai-mcp --http --port 3737
# 健康检查：GET /healthz，MCP端点：POST /
# PORT环境变量存在时（Vercel等服务器平台）自动启动HTTP模式
```
## 开发
```bash
npm install # 依赖安装（prepare自动构建）
npm run build:data # data/source/*.csv → data/generated/*.json重新生成
npm run build # TypeScript编译
npm test # 烟雾测试（MCP客户端-服务器往返）
```
```
data/source/ 原始CSV（成就标准，资源地图目录）
data/generated/ 编译后的JSON（打包到package.json中，提交）
src/ MCP服务器（工具·提示·搜索）
src/prompts/ 课程设计流程提示
```
## 数据来源与许可
- **GEP-AI研究**：『开发环境教育资源地图和建立基于AI的教师课程设计利用体系』最终报告（教育部·韩国环境保护研究院招标，国立公州大学产业合作团执行，研究负责人： 이재영，2026年2月）
- **代码**：MIT License
- **成就标准**：2022年修订课程标准（教育部公告）公共数据
- **资料目录**：基于教育部资源地图输入数据的元数据。资料原文版权归各省市教育厅所有，本服务器仅提供元数据（标题、来源、分类）。
- **学习轮模型**： 이재영教授的学习模型。 本服务器仅包含模型结构摘要。
## 路线图
- [x] npm包发布 (`npx gepai-mcp`) — [gepai-mcp@0.1.0](https://www.npmjs.com/package/gepai-mcp)
- [x] 远程MCP发布 — https://gepai-mcp.vercel.app （教师只需注册URL即可使用）
- [x] 资料原文深入搜索 — v0.3.0： 22,341块内嵌BM25全文搜索（无需嵌入，AI进行意义重新排序）
- [x] 资料原始链接 — v0.4.0： 资料集 41个官方页面URL（教育厅资料库 · 网络杂志 · 电子书），连接到517个资料 · 文档487个 — 资料 517个 · 文档 487个
- [x] 原文PDF直接链接 — v0.5.0： 教育厅资料PDF放入Google Drive存储，文档 997/1,053（95%）文件链接 — 点击一次即可查看。 剩余分校提交的行信息报告60件因个人信息问题排除，未上传分卷本等56件通过官方资料库指南替代）
- [x] 各平台安装指南 — [docs/INSTALL.md](docs/INSTALL.md) （Claude · ChatGPT · Codex · Gemini · Antigravity · Cursor，官方文档验证）
- [ ] 安装指南截图增强
*GEP-AI：让所有人都能使用教育部环境教育研究项目的成果。*
