Skip to main content
Glama
deenesjakoruzh
KonghaYao

mcp-skills-registry

by KonghaYao
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

monorepo — ejemplo de servidor agregado MCPP

Demuestra la topología monorepo de MCPP 3.7: una única salida HTTP, con enrutamiento por ruta a sub servidores.

Forma

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

  • Cada ruta es un endpoint MCP independiente; las skills, los recursos y las sesiones están aislados entre sí.

  • src/registry.ts es el único registro de enrutamiento compartido entre el punto de entrada local, Cloudflare Worker y las pruebas.

  • stdio no tiene concepto de URL/ruta, por lo que no es aplicable a esta forma de agregación.

Related MCP server: MCP Skill Registry

Inicialización

bun run init

Este comando instala las dependencias, reproduce las skills de terceros según skills.lock.json y genera un registro estático que el Worker puede empaquetar.

Comandos comunes

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

Estructura de directorios

├── 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

Construcción de Skills reproducibles

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

Ni el directorio generado ni el registro se envían al repositorio; un nuevo clon los restaura completamente mediante bun run init. El sub servidor no lee node:fs en tiempo de ejecución, por lo que el bundle del Worker incluirá el contenido de SKILL.md.

Despliegue en Cloudflare

bun run deploy:dry-run
bun run deploy

El registro de sesiones es estado en memoria del isolate; para concurrencia con múltiples instancias en producción, es necesario externalizar el estado de las sesiones a Durable Objects.

Relacionado

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