内容
# Gaia MCP
Agent-native discovery, trust, installation, and progression for the
[Gaia 技能树](https://github.com/gaia-research/gaia-skill-tree).
> **状态：** `v0.1.0` 受信任的发现实现正在审查中。
> npm 包尚未发布；请使用下面的本地开发说明，直到第一个版本通过其发布门槛。
Gaia MCP 让 AI 代理在用户的当前对话中回答一个实际问题：
> 哪些有证据支持的技能适合这项任务，为什么我应该信任它，并且我可以安全地将其添加到这个工作区吗？
它是独立的 Gaia Research 工具。它从 Gaia 技能树中获取规范的公共数据和验证的本地操作；它不直接拥有或改变注册表。
## 仓库角色
| 仓库 | 责任 |
|---|---|
| [`gaia-skill-tree`](https://github.com/gaia-research/gaia-skill-tree) | 规范注册表、模式、公共数据、信任幅度和验证的 CLI 操作。 |
| [`gaia-research`](https://github.com/gaia-research/gaia-research) | 面向人类的门户、研究、报告和未来的 Gaia MCP 产品页面。 |
| **`gaia-mcp`** | 代理面临的发现、比较、推荐、安装协调和进度指导。 |
| [`skill-fuse`](https://github.com/gaia-research/skill-fuse) | 创造性创作：将安装的技能合并成一个新的 `SKILL.md`。 |
| [`gaia-operator`](https://github.com/gaia-research/gaia-operator) | 受保护的浏览器和平台交互运行时。 |
## v0.1 工具表面
- `gaia_search` — 按任务和约束查找通用和命名技能。
- `gaia_inspect` — 返回有证据支持的技能档案。
- `gaia_status` — 报告服务器兼容性、注册表新鲜度、计数和源 URL。
前三个工具在 `v0.1.0` 中以只读注册表模式实现；`gaia_analyze_project` 和 `gaia_plan_path` 将在 `v0.2.0` 中以绑定模式到达。
安装、更新和 Intake 提交仅在只读表面可信后才到达。每个操作都将通过规范的 Gaia CLI 进行，并需要在更改工作区或外部状态时获得明确批准。
## 运行开发服务器
需要 Node.js 22.14 或更新版本。
```sh
npm ci
npm run build
node dist/bin/gaia-mcp.js
```
服务器通过 stdio 通信 MCP，因此在直接运行时通常显示为空闲状态。
使用 `dist/bin/gaia-mcp.js` 的绝对路径从 MCP 客户端连接它。
在 `v0.1.0` 发布并通过其干净安装门槛后，Claude Code 安装将被版本固定：
```sh
claude mcp add gaia -- npx -y @gaia-research/mcp@0.1.0
```
在 [Gaia MCP 版本](https://github.com/gaia-research/gaia-mcp/releases) 中出现该 npm 包之前，请勿使用此 npm 命令。
公共投影端点可以为测试覆盖，使用 `GAIA_REGISTRY_URL` 和 `GAIA_NAMED_SKILLS_URL`。
## 验证
```sh
npm run check # 类型检查、单元/协议测试、构建
npm run test:live # 当前 gaiaskilltree.com 数据合约
npm pack --dry-run # 可发布工件内容
```
## 设计文档
- [架构](ARCHITECTURE.md)
- [交付路线图](ROADMAP.md)
- [版本控制和发布](VERSIONING.md)
- [兼容性](COMPATIBILITY.md)
- [变更日志](CHANGELOG.md)
## 跨仓库跟踪
- [`gaia-mcp` v0.1 实现和发布](https://github.com/gaia-research/gaia-mcp/issues/1)
- [创始人 npm 启动和受信任发布者交接](https://github.com/gaia-research/gaia-mcp/issues/2)
- [Gaia 技能树提取和路线图 v5 RFC](https://github.com/gaia-research/gaia-skill-tree/issues/1191)
- [Gaia Research 网站集成和消费者测试](https://github.com/gaia-research/gaia-research/issues/53)
## 非目标
Gaia MCP 不是：
- 围绕每个 `gaia` 命令的对话式包装器；
- 第二个注册表实现；
- 创造性地融合 `SKILL.md` 文件的引擎；
- 直接注册表或技能树突变路径；
- 后台更新守护进程；
- Gaia Research 网站运行时的组成部分。
## 许可证
[MIT](LICENSE)
