Remove package_canonical (#59)

I originally introduced `package_canonical` into the API schema because,
at the time, we were thinking to "pin" the version of the MCP server to
_one_ of the referenced source code packages.

We are no longer doing this (we are maintaining a separate notion of
`version` unique to the MCP server), so I don't believe
`package_canonical` is needed anymore. Does anyone see otherwise?

This change removes all mentions in READMEs and usages in code.

README.md

@@ -157,7 +157,6 @@ Response example:
     "release_date": "2025-05-16T19:13:21Z",
     "is_latest": true
   },
-  "package_canonical": "docker",
   "packages": [
     {
       "registry_name": "docker",
@@ -205,7 +204,6 @@ Request body example:
 {
     "description": "<your description here>",
     "name": "io.github.<owner>/<server-name>",
-    "package_canonical": "<package_registry",
     "packages": [
         {
             "registry_name": "npm",

api/README.md

@@ -59,7 +59,6 @@ GET /v0/servers/a5e8a7f0-d4e4-4a1d-b12f-2896a23fd4f1?version=0.0.3
     "release_date": "2023-06-15T10:30:00Z",
     "is_latest": true
   },
-  "package_canonical": "npm",
   "packages": [
     {
       "registry_name": "npm",
@@ -154,7 +153,6 @@ API Response:
     "release_date": "2023-06-15T10:30:00Z",
     "is_latest": true
   },
-  "package_canonical": "npm",
   "packages": [
     {
       "registry_name": "npm",
@@ -207,7 +205,6 @@ API Response:
     "release_date": "2023-06-15T10:30:00Z",
     "is_latest": true
   },
-  "package_canonical": "docker",
   "packages": [
     {
       "registry_name": "docker",

api/openapi.yaml

@@ -333,10 +333,6 @@ components:
         - $ref: '#/components/schemas/Server'
         - type: object
           properties:
-            package_canonical:
-              type: string
-              enum: [npm, docker, pypi, crates]
-              example: "npm"
             packages:
               type: array
               items:

internal/model/model.go

@@ -122,7 +122,6 @@ type Server struct {
 // ServerDetail represents detailed server information as defined in the spec
 type ServerDetail struct {
 	Server           `json:",inline" bson:",inline"`
-	PackageCanonical string    `json:"package_canonical,omitempty" bson:"package_canonical,omitempty"`
 	Packages         []Package `json:"packages,omitempty" bson:"packages,omitempty"`
 	Remotes          []Remote  `json:"remotes,omitempty" bson:"remotes,omitempty"`
 }

scripts/test_publish.sh

@@ -70,7 +70,6 @@ cat > "$PAYLOAD_FILE" << EOF
     "url": "https://github.com/example/test-mcp-server",
     "branch": "main"
   },
-  "package_canonical": "test-mcp-server",
   "registries": [
     {
       "name": "npm",

tools/publisher/mcp.json

@@ -1,7 +1,6 @@
 {
     "description": "<your description here>",
     "name": "io.github.<owner>/<server-name>",
-    "package_canonical": "<package_registry",
     "packages": [
         {
             "registry_name": "npm",