OpsGuide MCP Proxy

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

Installation

``bash
npm install -g opsguide-mcp
`

Or use with npx:

`bash
npx opsguide-mcp@latest YOUR_API_KEY
`

Usage

$3

`bash


Using command line argument

opsguide-mcp YOUR_API_KEY

Using environment variable

API_KEY=YOUR_API_KEY opsguide-mcp
`

$3

Add this to your MCP client configuration:

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

Or using environment variable:

`json
{
"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

`bash


Install dependencies

npm install

Build the project

npm run build

Test locally

npm run dev YOUR_API_KEY
``

License

MIT