Skip to main content
Glama
deenesjakoruzh
KonghaYao

mcp-skills-registry

by KonghaYao
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

monorepo — пример агрегированного сервера MCPP

Демонстрирует топологию monorepo MCPP 3.7: единый HTTP-выход, маршрутизация по путям к подсерверам.

Форма

                    ┌─────────────────────────────────────────────┐
  客户端             │ monorepo（单一 HTTP server，端口 8787）      │
                    │                                             │
  /openspec/mcp   ──► OpenSpec skills sub server                  │
  /mattpocock/mcp ──► Matt Pocock skills sub server               │
  其他路径         ──► 404                                         │
                    └─────────────────────────────────────────────┘

  • Каждый путь — независимая конечная точка MCP; навыки, ресурсы и сеансы изолированы друг от друга.

  • src/registry.ts — единый реестр маршрутов, общий для локального входа, Cloudflare Worker и тестов.

  • stdio не имеет концепции URL/пути и не подходит для этой агрегированной формы.

Related MCP server: MCP Skill Registry

Инициализация

bun run init

Эта команда устанавливает зависимости, воспроизводит сторонние навыки согласно skills.lock.json и генерирует статический реестр, который можно упаковать в Worker.

Часто используемые команды

bun dev                     # 构建 skills 后启动 http://127.0.0.1:8787/
bun run demo                # 端到端 smoke 测试
bun run skills:sync         # 按 lock 同步第三方 skills
bun run skills:update       # 更新第三方 commit 并重新生成 registry
bun run deploy:dry-run      # 验证 Cloudflare Worker bundle
bun run deploy              # 部署 Cloudflare Worker

Структура каталогов

├── src/
│   ├── index.ts                 # 本地网关和纯 fetch handler
│   ├── registry.ts              # 唯一 sub server 注册表
│   └── static-skills.ts         # 静态 skills resource 挂载器
├── servers/
│   ├── openspec/
│   │   ├── server.ts
│   │   ├── skills/              # 生成、Git ignored
│   │   └── skills.generated.ts  # 生成、Git ignored
│   └── mattpocock/
│       ├── server.ts
│       ├── skills/              # 生成、Git ignored
│       └── skills.generated.ts  # 生成、Git ignored
├── install-skills.js            # manifest + lock 同步器
├── generate-skills-registry.js  # 静态 registry 生成器
├── skills.json                  # source 声明
├── skills.lock.json             # 锁定 commit，提交进 Git
├── test/smoke.ts
├── worker.ts
└── wrangler.jsonc

Воспроизводимая сборка навыков

skills.json + skills.lock.json
            │
            ▼
     install-skills.js
            │ copy 锁定 commit
            ▼
 servers/<id>/skills/
            │
            ▼
generate-skills-registry.js
            │
            ▼
servers/<id>/skills.generated.ts
            │ static import
            ▼
      Bun / Worker bundle

Сгенерированные каталоги и реестр не фиксируются; новый клон полностью восстанавливается с помощью bun run init. Подсервер не читает node:fs во время выполнения, поэтому пакет Worker будет содержать текст SKILL.md.

Развертывание на Cloudflare

bun run deploy:dry-run
bun run deploy

Реестр сеансов находится в памяти изолята; для параллельной работы нескольких экземпляров в производстве необходимо вынести состояние сеансов в Durable Objects.

Связанное

  • Спецификация: MCPP.md

  • Пакет спецификации: @peri-code/mcpp

  • Соглашение о размещении: agent-plugins.org

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers