Files
registry/README.md
Johnson 3479e182ab feat: Registry v2 目录重构 — MCP/HTTP 分离 + install/connection 配置
- 新增 mcp/index.json:MCP 服务独立目录,含 install 和 connection 字段
- 新增 services/index.json:仅 HTTP 服务
- 新增 apps/index.json:应用增加 install 字段
- 新增 models/:descriptors + categories 从 services/ 移出
- 更新 manifest.json:版本升级到 2.0.0,统计拆分 MCP/HTTP
- 更新 SCHEMA_VERSION:1.0.0 → 2.0.0
- 旧文件保留用于向后兼容

新增 7 个 MCP 服务条目(含真实包名和安装命令):
  - Filesystem MCP (@modelcontextprotocol/server-filesystem)
  - GitHub MCP (@modelcontextprotocol/server-github)
  - Playwright MCP (@playwright/mcp)
  - Dify MCP Bridge
  - Database MCP (@modelcontextprotocol/server-postgres)
  - Memory MCP (@modelcontextprotocol/server-memory)
  - Fetch MCP (mcp-server-fetch, uvx)
2026-02-24 23:59:59 +08:00

69 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# DesireCore Registry
DesireCore 官方应用商店与服务注册表数据仓库。
## 目录结构
```
.
├── README.md # 本文件
├── SCHEMA_VERSION # 数据格式版本2.0.0
├── manifest.json # 仓库元数据
├── apps/
│ ├── index.json # StoreApp[] 应用列表v2: 含 install 字段)
│ └── apps.json # [旧版兼容] 应用列表
├── mcp/
│ └── index.json # RegisteredService[] MCP 服务(含 install + connection
├── services/
│ ├── index.json # RegisteredService[] HTTP 服务
│ ├── services.json # [旧版兼容] 所有服务MCP + HTTP 混合)
│ ├── descriptors.json # [旧版兼容] → models/descriptors.json
│ └── categories.json # [旧版兼容] → models/categories.json
├── models/
│ ├── descriptors.json # ServiceDescriptor[] 模型能力描述符
│ └── categories.json # ServiceCategoryDescriptor[] 模型分类
└── ui-config/
├── app-categories.json # 应用分类配置
└── service-status.json # 服务状态 UI 配置
```
## v2 新增
- **`mcp/index.json`**MCP 服务独立目录,每个条目包含 `install`(安装方式)和 `connection`(连接配置)
- **`models/`**AI 模型描述符从 `services/` 移出
- **`apps/index.json`**:应用增加 `install` 字段
- **`services/index.json`**:仅 HTTP 服务
旧路径文件保留用于向后兼容,新版客户端优先读取新路径。
## 数据格式
所有 JSON 文件遵循 DesireCore 定义的 JSON Schema
- `apps/index.json``StoreApp` schema`install`
- `mcp/index.json``RegisteredService` schema`install` + `connection`
- `services/index.json``RegisteredService` schema
- `models/descriptors.json``ServiceDescriptor` schema
- `models/categories.json``ServiceCategoryDescriptor` schema
## 同步策略
DesireCore 客户端会:
1. 启动时检查本地缓存2 分钟 TTL
2. 缓存过期时 `git fetch` 检查更新
3. 有更新时 `git pull` 并重建索引
4. 离线时使用本地缓存或内置 fallback 数据
## 贡献指南
1. Fork 本仓库
2. 修改相应的 JSON 文件
3. 提交 PR 并描述变更内容
4. 等待审核合并
## 镜像
- GitHub: https://github.com/desirecore/registry.git
- git.hxr.so镜像: https://git.hxr.so/desirecore/registry.git