PoC full flow (hello world example)

tommaso-moro · mattdholloway · commit 67a479343027 · 2026-02-02T16:54:32.000Z
diff --git a/internal/ghmcp/server.go b/internal/ghmcp/server.go
@@ -250,6 +250,9 @@ func NewMCPServer(cfg MCPServerConfig) (*mcp.Server, error) {
 	// enable toolsets or tools explicitly that do need registration).
 	inventory.RegisterAll(context.Background(), ghServer, deps)
 
+	// Register MCP App UI resources (static resources for tool UI)
+	github.RegisterUIResources(ghServer)
+
 	// Register dynamic toolset management tools (enable/disable) - these are separate
 	// meta-tools that control the inventory, not part of the inventory itself
 	if cfg.DynamicToolsets {
diff --git a/pkg/github/context_tools.go b/pkg/github/context_tools.go
@@ -15,6 +15,37 @@ import (
 	"github.com/shurcooL/githubv4"
 )
 
+// GetMeUIResourceURI is the URI for the get_me tool's MCP App UI resource.
+const GetMeUIResourceURI = "ui://github-mcp-server/get-me"
+
+// GetMeUIHTML is the HTML content for the get_me tool's MCP App UI.
+// This is a simple "Hello World" demo with bold red text.
+const GetMeUIHTML = `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>GitHub MCP Server - Get Me</title>
+    <style>
+        body {
+            font-family: var(--font-sans, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif);
+            padding: 20px;
+            margin: 0;
+            background: var(--color-background-primary, #fff);
+            color: var(--color-text-primary, #333);
+        }
+        .hello-world {
+            font-weight: bold;
+            color: red;
+            font-size: 1.5em;
+        }
+    </style>
+</head>
+<body>
+    <p class="hello-world">Hello World</p>
+</body>
+</html>`
+
 // UserDetails contains additional fields about a GitHub user not already
 // present in MinimalUser. Used by get_me context tool but omitted from search_users.
 type UserDetails struct {
@@ -51,6 +82,12 @@ func GetMe(t translations.TranslationHelperFunc) inventory.ServerTool {
 			// Use json.RawMessage to ensure "properties" is included even when empty.
 			// OpenAI strict mode requires the properties field to be present.
 			InputSchema: json.RawMessage(`{"type":"object","properties":{}}`),
+			// MCP Apps UI metadata - links this tool to its UI resource
+			Meta: mcp.Meta{
+				"ui": map[string]any{
+					"resourceUri": GetMeUIResourceURI,
+				},
+			},
 		},
 		nil,
 		func(ctx context.Context, deps ToolDependencies, _ *mcp.CallToolRequest, _ map[string]any) (*mcp.CallToolResult, any, error) {
diff --git a/pkg/github/ui_resources.go b/pkg/github/ui_resources.go
@@ -0,0 +1,33 @@
+package github
+
+import (
+	"context"
+
+	"github.com/modelcontextprotocol/go-sdk/mcp"
+)
+
+// RegisterUIResources registers MCP App UI resources with the server.
+// These are static resources (not templates) that serve HTML content for
+// MCP App-enabled tools.
+func RegisterUIResources(s *mcp.Server) {
+	// Register the get_me UI resource
+	s.AddResource(
+		&mcp.Resource{
+			URI:         GetMeUIResourceURI,
+			Name:        "get_me_ui",
+			Description: "MCP App UI for the get_me tool",
+			MIMEType:    "text/html",
+		},
+		func(_ context.Context, _ *mcp.ReadResourceRequest) (*mcp.ReadResourceResult, error) {
+			return &mcp.ReadResourceResult{
+				Contents: []*mcp.ResourceContents{
+					{
+						URI:      GetMeUIResourceURI,
+						MIMEType: "text/html",
+						Text:     GetMeUIHTML,
+					},
+				},
+			}, nil
+		},
+	)
+}
