Files
github--github-mcp-server/pkg/github/ui_resources.go
Matt Holloway 69f786b87c Align UI resources with MCP Apps 2026-01-26 polish recommendations
* Explicitly set prefersBorder on every UI resource — false for the
  get_me profile card, true for the issue/PR write forms — since
  hosts' defaults vary.
* Declare an empty csp on issue_write_ui and pr_write_ui to document
  that they need no external origins.
* Point spec link comment at the stable 2026-01-26 location.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-05-29 19:41:54 +02:00

107 lines
3.0 KiB
Go

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. The HTML is built from React/Primer components
// in the ui/ directory using `script/build-ui`.
//
// Resource metadata follows the stable 2026-01-26 MCP Apps spec:
// https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx
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: MCPAppMIMEType,
},
func(_ context.Context, _ *mcp.ReadResourceRequest) (*mcp.ReadResourceResult, error) {
html := MustGetUIAsset("get-me.html")
return &mcp.ReadResourceResult{
Contents: []*mcp.ResourceContents{
{
URI: GetMeUIResourceURI,
MIMEType: MCPAppMIMEType,
Text: html,
Meta: mcp.Meta{
"ui": map[string]any{
// Allow loading images from GitHub's avatar CDN.
"csp": map[string]any{
"resourceDomains": []string{"https://avatars.githubusercontent.com"},
},
// Profile card renders inline within chat without a host border.
"prefersBorder": false,
},
},
},
},
}, nil
},
)
// Register the issue_write UI resource
s.AddResource(
&mcp.Resource{
URI: IssueWriteUIResourceURI,
Name: "issue_write_ui",
Description: "MCP App UI for creating and updating GitHub issues",
MIMEType: MCPAppMIMEType,
},
func(_ context.Context, _ *mcp.ReadResourceRequest) (*mcp.ReadResourceResult, error) {
html := MustGetUIAsset("issue-write.html")
return &mcp.ReadResourceResult{
Contents: []*mcp.ResourceContents{
{
URI: IssueWriteUIResourceURI,
MIMEType: MCPAppMIMEType,
Text: html,
Meta: mcp.Meta{
"ui": map[string]any{
// No external origins required; documents the secure default.
"csp": map[string]any{},
// Form surface benefits from a host-provided border.
"prefersBorder": true,
},
},
},
},
}, nil
},
)
// Register the create_pull_request UI resource
s.AddResource(
&mcp.Resource{
URI: PullRequestWriteUIResourceURI,
Name: "pr_write_ui",
Description: "MCP App UI for creating GitHub pull requests",
MIMEType: MCPAppMIMEType,
},
func(_ context.Context, _ *mcp.ReadResourceRequest) (*mcp.ReadResourceResult, error) {
html := MustGetUIAsset("pr-write.html")
return &mcp.ReadResourceResult{
Contents: []*mcp.ResourceContents{
{
URI: PullRequestWriteUIResourceURI,
MIMEType: MCPAppMIMEType,
Text: html,
Meta: mcp.Meta{
"ui": map[string]any{
"csp": map[string]any{},
"prefersBorder": true,
},
},
},
},
}, nil
},
)
}