Merge pull request github#202 from docker/add-astro-docs-server

Add remote MCP Servers to registry and add validation check to transport_type

Author: kgprs

cmd/validate/main.go

@@ -56,6 +56,10 @@ func run(name string) error {
 	if err := isRemoteValid(name); err != nil {
 		return err
 	}
+	
+	if err := isOAuthDynamicValid(name); err != nil {
+		return err
+	}
 
 	return nil
 }
@@ -233,10 +237,41 @@ func isRemoteValid(name string) error {
 		return fmt.Errorf("remote server must have a transport_type specified")
 	}
 
+	// Validate transport_type is one of the allowed values
+	validTransports := []string{"stdio", "sse", "streamable-http"}
+	isValid := false
+	for _, valid := range validTransports {
+		if server.Remote.TransportType == valid {
+			isValid = true
+			break
+		}
+	}
+	if !isValid {
+		return fmt.Errorf("remote server transport_type must be one of: stdio, sse, streamable-http (got: %s)", server.Remote.TransportType)
+	}
+
 	fmt.Println("✅ Remote is valid")
 	return nil
 }
 
+// check if servers with OAuth have dynamic tools enabled
+func isOAuthDynamicValid(name string) error {
+	server, err := readServerYaml(name)
+	if err != nil {
+		return err
+	}
+
+	// If server has OAuth configuration, it must have dynamic tools enabled
+	if len(server.OAuth) > 0 {
+		if server.Dynamic == nil || !server.Dynamic.Tools {
+			return fmt.Errorf("server with OAuth must have 'dynamic: tools: true' configuration")
+		}
+	}
+
+	fmt.Println("✅ OAuth dynamic configuration is valid")
+	return nil
+}
+
 func readServerYaml(name string) (servers.Server, error) {
 	serverYaml, err := os.ReadFile(filepath.Join("servers", name, "server.yaml"))
 	if err != nil {

pkg/servers/types.go

@@ -28,10 +28,15 @@ import (
 	"gopkg.in/yaml.v3"
 )
 
+type Dynamic struct {
+	Tools bool `yaml:"tools,omitempty" json:"tools,omitempty"`
+}
+
 type Server struct {
 	Name        string          `yaml:"name" json:"name"`
 	Image       string          `yaml:"image,omitempty" json:"image,omitempty"`
 	Type        string          `yaml:"type" json:"type"`
+	Dynamic     *Dynamic        `yaml:"dynamic,omitempty" json:"dynamic,omitempty"`
 	LongLived   bool            `yaml:"longLived,omitempty" json:"longLived,omitempty"`
 	Meta        Meta            `yaml:"meta,omitempty" json:"meta,omitempty"`
 	About       About           `yaml:"about,omitempty" json:"about,omitempty"`

servers/apify/readme.md

@@ -0,0 +1 @@
+Docs: https://docs.apify.com/platform/integrations/mcp

servers/apify/server.yaml

@@ -0,0 +1,23 @@
+name: apify
+type: remote
+dynamic:
+  tools: true
+meta:
+  category: automation
+  tags:
+    - automation
+    - web-scraping
+    - data-extraction
+    - remote
+about:
+  title: Apify
+  description: Web Data Extraction Platform
+  icon: https://www.google.com/s2/favicons?domain=apify.com&sz=64
+remote:
+  transport_type: streamable-http
+  url: https://mcp.apify.com
+config:
+  secrets:
+    - name: apify.api_key
+      env: APIFY_API_KEY
+      example: <YOUR_API_KEY>

servers/apify/tools.json

@@ -0,0 +1 @@
+[]

servers/asana/server.yaml

@@ -0,0 +1,20 @@
+name: asana
+type: remote
+dynamic:
+  tools: true
+meta:
+  category: productivity
+  tags:
+    - productivity
+    - project-management
+    - collaboration
+    - remote
+about:
+  title: Asana
+  description: Project Management
+  icon: https://www.google.com/s2/favicons?domain=asana.com&sz=64
+remote:
+  transport_type: sse
+  url: https://mcp.asana.com/sse
+oauth:
+  - provider: asana

servers/asana/tools.json

@@ -0,0 +1 @@
+[]

servers/astro-docs/readme.md

@@ -0,0 +1 @@
+Docs: https://docs.astro.build/en/guides/build-with-ai/

servers/astro-docs/server.yaml

@@ -0,0 +1,20 @@
+name: astro-docs
+type: remote
+# dynamic:
+#   tools: true
+meta:
+  category: documentation
+  tags:
+    - documentation
+    - astro
+    - web-framework
+    - remote
+about:
+  title: Astro Docs
+  description: Access the latest Astro web framework documentation, guides, and API references
+  icon: https://astro.build/favicon.svg
+remote:
+  transport_type: streamable-http
+  url: https://mcp.docs.astro.build/mcp
+source:
+  project: https://github.com/withastro/docs-mcp

servers/astro-docs/tools.json

@@ -0,0 +1,14 @@
+[
+  {
+    "name": "search_astro_docs",
+    "description": "Search the official Astro framework docs",
+    "arguments": [
+      {
+        "name": "query",
+        "type": "string",
+        "description": "Search query",
+        "required": true
+      }
+    ]
+  }
+]