Add MCP docs server to Claude Code GitHub Action

[olaservo]

Summary

Add MCP docs server configuration to the Claude Code GitHub Action, enabling Claude to look up the latest MCP protocol documentation and schema references when working on MCP-related code or reviewing changes.

Type of Change

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Documentation update
• Refactoring (no functional changes)
• Test updates
• Build/CI improvements

Changes Made

1. Added .mcp.json - New MCP server configuration file at project root with the mcp-docs HTTP server:

   {
     "mcpServers": {
       "mcp-docs": {
         "type": "http",
         "url": "https://modelcontextprotocol.io/mcp"
       }
     }
   }

2. Updated .github/workflows/claude.yml:

   • Added --mcp-config .mcp.json to load the MCP server configuration
   • Changed --system-prompt to --append-system-prompt to preserve Claude Code's default capabilities
   • Extended instructions to tell Claude to use the mcp-docs server for MCP-related work and reference the schema at https://github.com/modelcontextprotocol/modelcontextprotocol/tree/main/schema

Related Issues

N/A

Testing

Have not tested this yet.

• Tested in UI mode
• Tested in CLI mode
• Tested with STDIO transport
• Tested with SSE transport
• Tested with Streamable HTTP transport
• Added/updated automated tests
• Manual testing performed

Test Results and/or Instructions

This is a CI configuration change. To verify:

1. Trigger the Claude Code action on a PR or issue mentioning @claude with an MCP-related question
2. Verify Claude uses the mcp-docs MCP server to look up documentation

Checklist

• Code follows the style guidelines (ran npm run prettier-fix)
• Self-review completed
• Code is commented where necessary
• Documentation updated (README, comments, etc.)

Breaking Changes

None

Additional Context

The .mcp.json file also benefits local Claude Code CLI users who clone the repository, as it will automatically configure the mcp-docs server for them.

[olaservo]

Converting to draft until I fix a couple issues with allowed tools config

[richardkmichael]

👍 I've been doing this for awhile and it works well.

I had noticed the use of --system-prompt vs. --append-system-prompt, and wondered if that had been getting better "review" results by removing Claude's focus on software engineering.

[olaservo]

Hi @cliffhall , I finally took this out of draft - this should help as a reference for when we tag claude in the repo.

[cliffhall]

LGTM! 👍