Transparent MCP proxy for OpsGuide Amazon Bedrock AgentCore Gateway
npm install opsguide-mcpA transparent Model Context Protocol (MCP) proxy that forwards all requests to the OpsGuide Amazon Bedrock AgentCore Gateway.
``bash`
npm install -g opsguide-mcp
Or use with npx:
`bash`
npx opsguide-mcp@latest YOUR_API_KEY
`bashUsing command line argument
opsguide-mcp YOUR_API_KEY
$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 stdoutAvailable 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 promptConfiguration
- 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 variableDevelopment
`bash
Install dependencies
npm installBuild the project
npm run buildTest locally
npm run dev YOUR_API_KEY
``MIT