Golden Path stdio MCP Server

TypeScript/Node.js stdio MCP server for Golden Path registry operations.

Architecture

Claude Code ←stdio→ Node.js MCP Server ←HTTPS→ REST API ←S3

The MCP server runs locally via stdio and makes HTTP calls to the Golden Path REST API.

Installation

Via npx (Recommended)

npx -y @goldenpathsdev/goldenpath-mcp

Via npm

npm install -g @goldenpathsdev/goldenpath-mcp

Configuration

Create ~/.goldenpath/config.json:

{
  "api_key": "gp_dev_hardcoded",
  "api_base": "https://api.goldenpath.dev"
}

Or use environment variables:

export GOLDENPATH_API_KEY="your-api-key"
export GOLDENPATH_API_BASE="https://api.goldenpath.dev"

Add to ~/.claude.json:

{
  "mcpServers": {
    "goldenpath": {
      "command": "npx",
      "args": ["-y", "@goldenpathsdev/goldenpath-mcp"]
    }
  }
}

Tools

• create_golden_path - Upload Golden Path from local file to registry
• fetch_golden_path - Fetch Golden Path from registry
• list_golden_paths - List available Golden Paths
• search_golden_paths - Search by query
• delete_golden_path - Delete from registry

Development

Install Dependencies

npm install

Build

npm run build

Watch Mode

npm run watch

Local Testing

node build/index.js

Publishing

npm version patch
npm publish --access public

Architecture Notes

• stdio transport: No network exposure, communicates via stdin/stdout
• HTTP client: Makes fetch() calls to REST API
• API authentication: Bearer token from config or environment
• No AWS credentials: API handles S3 operations

Previous Implementation

Python HTTP MCP implementation archived in branch: archive/python-http-mcp