Skip to main content
Glama
deenesjakoruzh
KonghaYao

mcp-skills-registry

by KonghaYao
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Monorepo – MCPP Aggregator-Server-Beispiel

Demonstriert die Monorepo-Topologie von MCPP 3.7: Ein einzelner HTTP-Endpunkt, Pfad-Routing zu Sub-Servern.

Form

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

  • Jeder Pfad ist ein unabhängiger MCP-Endpunkt; Skills, Ressourcen und Sitzungen sind voneinander isoliert.

  • src/registry.ts ist das einzige gemeinsame Routing-Register für den lokalen Einstiegspunkt, den Cloudflare Worker und Tests.

  • Stdio hat kein URL/Pfad-Konzept und ist für diese Aggregationsform nicht geeignet.

Related MCP server: MCP Skill Registry

Initialisierung

bun run init

Dieser Befehl installiert Abhängigkeiten, reproduziert Drittanbieter-Skills gemäß skills.lock.json und erzeugt ein statisches Register, das der Worker paketieren kann.

Häufige Befehle

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

Verzeichnisstruktur

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

Reproduzierbarer Skills-Build

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

Weder das generierte Verzeichnis noch das generierte Register werden eingecheckt; ein neuer Klon stellt alles über bun run init vollständig wieder her. Der Sub-Server liest zur Laufzeit kein node:fs, daher enthält das Worker-Bundle den SKILL.md-Text.

Cloudflare-Bereitstellung

bun run deploy:dry-run
bun run deploy

Das Sitzungsregister befindet sich im Isolat-Arbeitsspeicher; bei parallelen Produktionsinstanzen muss der Sitzungszustand in Durable Objects ausgelagert werden.

Verwandtes

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