conda env create -f environment.yml
conda activate mcp
npm install
npm run build

npm start

npx @modelcontextprotocol/inspector node dist/index.js
# Open http://localhost:6274

{
  "mcpServers": {
    "fetch": {
      "command": "node",
      "args": ["/path/to/mcp/dist/index.js"]
    }
  }
}

# 1. Generate an admin token (save this securely)
REGISTRY_JWT_SECRET=your-secret npm run generate-token

# 2. Start the registry
REGISTRY_JWT_SECRET=your-secret npm run registry

TOKEN="<your-generated-token>"

# Publish a server
curl -X POST http://localhost:3000/v0.1/publish \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "io.example/fetch-server",
    "version": "1.0.0",
    "description": "HTTP fetch MCP server",
    "repository": "https://github.com/example/fetch-server"
  }'

# List all servers
curl http://localhost:3000/v0.1/servers

# Get latest version (/ in name must be URL-encoded as %2F)
curl "http://localhost:3000/v0.1/servers/io.example%2Ffetch-server/versions/latest"

# Search
curl "http://localhost:3000/v0.1/servers?search=fetch"

# Delete a version
curl -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  "http://localhost:3000/v0.1/servers/io.example%2Ffetch-server/versions/1.0.0"

src/
├── index.ts                  # MCP server entry point
└── registry/
    ├── index.ts              # Registry HTTP server entry point
    ├── db.ts                 # SQLite schema and query helpers
    ├── auth.ts               # JWT Bearer middleware
    ├── types.ts              # TypeScript types (OpenAPI spec)
    ├── generate-token.ts     # Admin JWT generator
    └── routes/
        ├── servers.ts        # GET endpoints
        └── publish.ts        # POST / PUT / DELETE endpoints
plans/
└── PLAN.md                   # Implementation plan