Skip to main content
Glama
deenesjakoruzh
KonghaYao

mcp-skills-registry

by KonghaYao
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

monorepo — MCPP 集約サーバーの例

MCPP 3.7 の monorepo トポロジーを実演：単一の HTTP 出口、パスルーティングをサブサーバーへ。

形態

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

  • 各パスは独立した MCP エンドポイントであり、skills、resources、およびセッションは相互に分離されています。

  • src/registry.ts はローカルエントリ、Cloudflare Worker、およびテストで共有される唯一のルーティングレジストリです。

  • stdio には URL/パスの概念がなく、この集約形態には適用されません。

Related MCP server: MCP Skill Registry

初期化

bun run init

このコマンドは依存関係をインストールし、skills.lock.json に従ってサードパーティの skills を再現し、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 ビルド

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

生成されたディレクトリとレジストリはコミットしません。新しい clone では bun run init で完全に復元します。サブサーバーは実行時に node:fs を読み取らないため、Worker bundle には SKILL.md の本文が含まれます。

Cloudflare デプロイ

bun run deploy:dry-run
bun run deploy

セッションレジストリは isolate のメモリ状態です。本番の複数インスタンス同時実行では、セッション状態を Durable Objects に外部化する必要があります。

関連

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