OpsGuide MCP Proxy

A transparent Model Context Protocol (MCP) proxy that forwards all requests to the OpsGuide Amazon Bedrock AgentCore Gateway.

Installation

npm install -g opsguide-mcp

Or use with npx:

npx opsguide-mcp@latest YOUR_API_KEY

Usage

Command Line

# Using command line argument
opsguide-mcp YOUR_API_KEY

# Using environment variable
API_KEY=YOUR_API_KEY opsguide-mcp

MCP Client Configuration

Add this to your MCP client configuration:

{
  "mcpServers": {
    "opsguide": {
      "command": "npx",
      "args": ["-y", "opsguide-mcp@latest", "YOUR_API_KEY"]
    }
  }
}

Or using environment variable:

{
  "mcpServers": {
    "opsguide": {
      "opsguide": {
      "command": "npx",
      "args": ["-y", "opsguide-mcp@latest"],
      "env": {
        "API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

How It Works

This proxy server acts as a transparent bridge between MCP clients and the OpsGuide gateway:

1. Receives MCP requests from clients via stdin (JSON-RPC 2.0 format)
2. Forwards requests to the gateway with proper authentication headers:

   POST /mcp HTTP/1.1
   Host: d01-opsguide-mcp-dev-mcp-gateway-irgxqlnbu8.gateway.bedrock-agentcore.us-east-1.amazonaws.com
   Content-Type: application/json
   Authorization: Bearer YOUR_API_KEY
      
   {
     "jsonrpc": "2.0",
     "id": 1,
     "method": "tools/list",
     "params": {}
   }

3. Returns gateway responses to the client via stdout

Available Capabilities

The proxy exposes whatever tools, resources, and prompts are available on your OpsGuide gateway. Common MCP methods include:

• initialize - Initialize the MCP session
• tools/list - List available tools
• tools/call - Call a specific tool
• resources/list - List available resources
• resources/read - Read a specific resource
• prompts/list - List available prompts
• prompts/get - Get a specific prompt

Configuration

• BASE_URL: https://d01-opsguide-mcp-dev-mcp-gateway-irgxqlnbu8.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp (hardcoded)
• API_KEY: Provided via command line argument or environment variable

Development

# Install dependencies
npm install

# Build the project
npm run build

# Test locally
npm run dev YOUR_API_KEY

License

MIT