| Name | opsguide-mcp JSON |
| Version |
0.1.4
JSON |
| download |
| home_page | None |
| Summary | MCP Server proxy for Amazon Bedrock AgentCore Runtime |
| upload_time | 2025-09-13 02:59:21 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | None |
| keywords |
ai
bedrock
mcp
opsguide
proxy
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# OpsGuide MCP Proxy
A **stateless** Model Context Protocol (MCP) server proxy for OpsGuide's Amazon Bedrock AgentCore Runtime. This proxy creates fresh connections for each request, ensuring no sessions are maintained.
## Overview
This stateless proxy server acts as a bridge between:
- **MCP clients** (like Claude Desktop, Cursor) that communicate via stdio
- **Amazon Bedrock AgentCore Runtime** that hosts your MCP server via HTTP
```
Claude Desktop ↔ opsguide-mcp (stateless proxy) ↔ Fresh HTTP Connection ↔ Bedrock AgentCore ↔ Your Tools
```
### Key Features
- ✅ **Stateless Design**: No persistent connections or sessions
- ✅ **Fresh Connections**: Each request creates a new connection to Bedrock
- ✅ **Tool Proxying**: Forwards `list_tools` and `call_tool` requests
- ✅ **Simple Configuration**: Only requires API_KEY
## Features
- **Protocol Bridge**: Converts between stdio (MCP client) and HTTP (Bedrock AgentCore)
- **Tool Proxying**: Forwards all tool calls to your Bedrock-hosted MCP server
- **Resource Access**: Proxies resource reading and listing
- **Prompt Support**: Forwards prompt operations
- **uvx Compatible**: Easy installation and usage with `uvx`
- **Environment Configuration**: Uses standard environment variables
## Prerequisites
- Python 3.10 or higher
- `uv` package manager
- Amazon Bedrock AgentCore Runtime with deployed MCP server
- Valid API key and agent ARN
## Installation
### For Claude Code
Add this configuration to your Claude Code MCP settings:
```json
{
"mcpServers": {
"opsguide-mcp": {
"command": "uvx",
"args": ["opsguide-mcp@latest"],
"env": {
"API_KEY": "your-bearer-token"
}
}
}
}
```
### Direct Installation
```bash
# Install with uvx (recommended)
uvx opsguide-mcp
# Or install with pip
pip install opsguide-mcp
```
## Environment Variables
Only one environment variable is required:
- `API_KEY`: The bearer token for authentication
**Hardcoded Configuration:**
- `AGENT_ARN`: `arn:aws:bedrock-agentcore:us-east-1:654654574429:runtime/opsguide_mcp_server_example-feNooQ7JbB`
- `AWS_REGION`: `us-east-1`
### Example .env file
```env
API_KEY=eyJraWQiOiI3RG1ZaXlQbnpoUXR6cmRXNmtvWEd5anhaZU9FaitXcHBpck1rcDlvbHFjPSIsImFsZyI6IlJTMjU2In0...
```
## Usage
### With Claude Code
1. Configure the MCP server in Claude Code settings (see installation section)
2. Restart Claude Code
3. Your Bedrock-hosted MCP tools will be available in Claude Code
### Command Line
```bash
# Run directly
opsguide-mcp
# Run with uvx
uvx opsguide-mcp
# Run with environment variable
API_KEY="your-bearer-token" opsguide-mcp
```
## How It Works
1. **Startup**: The proxy server reads your environment variables
2. **Connection**: Establishes HTTP connection to Bedrock AgentCore Runtime
3. **Discovery**: Lists available tools, resources, and prompts from your MCP server
4. **Proxying**: Forwards all MCP requests from Claude Code to Bedrock AgentCore
5. **Response**: Returns results back to Claude Code via stdio
## Troubleshooting
### Common Issues
**Connection Failed**
- Verify your `API_KEY` is correct and not expired
- Check that your Bedrock AgentCore runtime is running
- Ensure you have network access to bedrock-agentcore.us-east-1.amazonaws.com
**No Tools Available**
- Check that your MCP server is properly deployed in Bedrock AgentCore
- Verify the runtime is in "DEFAULT" qualifier state
- Check logs for connection errors
**Authentication Errors**
- Ensure your API_KEY (bearer token) is valid and not expired
- Verify the token has permission to invoke the specified runtime
### Debug Mode
Run with debug logging:
```bash
PYTHONPATH=. python -m bedrock_mcp_proxy.server
```
## Development
### Local Development
```bash
# Clone the repository
git clone https://github.com/your-username/opsguide-mcp
cd opsguide-mcp
# Install dependencies
uv sync
# Run locally
uv run opsguide-mcp
```
### Testing
```bash
# Test the connection
python test_connection.py
```
## Security Considerations
- **API Keys**: Store API keys securely using environment variables or secure credential management
- **Network Access**: The proxy requires outbound HTTPS access to AWS Bedrock AgentCore
- **Authentication**: Bearer tokens should be rotated regularly
- **Logging**: Be careful not to log sensitive information
## License
MIT License - see LICENSE file for details.
## Support
For issues related to:
- **This proxy**: Open an issue on this repository
- **Bedrock AgentCore**: Consult AWS documentation
- **Claude Code**: Check Claude Code documentation
Raw data
{
"_id": null,
"home_page": null,
"name": "opsguide-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "ai, bedrock, mcp, opsguide, proxy",
"author": null,
"author_email": "Ekky Armandi <me@ekky.dev>",
"download_url": "https://files.pythonhosted.org/packages/22/ff/374d2f0737d3bed52f133aeef07467bc16c085110ebe92b152246e4bd5b0/opsguide_mcp-0.1.4.tar.gz",
"platform": null,
"description": "# OpsGuide MCP Proxy\n\nA **stateless** Model Context Protocol (MCP) server proxy for OpsGuide's Amazon Bedrock AgentCore Runtime. This proxy creates fresh connections for each request, ensuring no sessions are maintained.\n\n## Overview\n\nThis stateless proxy server acts as a bridge between:\n- **MCP clients** (like Claude Desktop, Cursor) that communicate via stdio\n- **Amazon Bedrock AgentCore Runtime** that hosts your MCP server via HTTP\n\n```\nClaude Desktop \u2194 opsguide-mcp (stateless proxy) \u2194 Fresh HTTP Connection \u2194 Bedrock AgentCore \u2194 Your Tools\n```\n\n### Key Features\n- \u2705 **Stateless Design**: No persistent connections or sessions\n- \u2705 **Fresh Connections**: Each request creates a new connection to Bedrock\n- \u2705 **Tool Proxying**: Forwards `list_tools` and `call_tool` requests\n- \u2705 **Simple Configuration**: Only requires API_KEY\n\n## Features\n\n- **Protocol Bridge**: Converts between stdio (MCP client) and HTTP (Bedrock AgentCore)\n- **Tool Proxying**: Forwards all tool calls to your Bedrock-hosted MCP server\n- **Resource Access**: Proxies resource reading and listing\n- **Prompt Support**: Forwards prompt operations\n- **uvx Compatible**: Easy installation and usage with `uvx`\n- **Environment Configuration**: Uses standard environment variables\n\n## Prerequisites\n\n- Python 3.10 or higher\n- `uv` package manager\n- Amazon Bedrock AgentCore Runtime with deployed MCP server\n- Valid API key and agent ARN\n\n## Installation\n\n### For Claude Code\n\nAdd this configuration to your Claude Code MCP settings:\n\n```json\n{\n \"mcpServers\": {\n \"opsguide-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"opsguide-mcp@latest\"],\n \"env\": {\n \"API_KEY\": \"your-bearer-token\"\n }\n }\n }\n}\n```\n\n### Direct Installation\n\n```bash\n# Install with uvx (recommended)\nuvx opsguide-mcp\n\n# Or install with pip\npip install opsguide-mcp\n```\n\n## Environment Variables\n\nOnly one environment variable is required:\n\n- `API_KEY`: The bearer token for authentication\n\n**Hardcoded Configuration:**\n- `AGENT_ARN`: `arn:aws:bedrock-agentcore:us-east-1:654654574429:runtime/opsguide_mcp_server_example-feNooQ7JbB` \n- `AWS_REGION`: `us-east-1`\n\n### Example .env file\n\n```env\nAPI_KEY=eyJraWQiOiI3RG1ZaXlQbnpoUXR6cmRXNmtvWEd5anhaZU9FaitXcHBpck1rcDlvbHFjPSIsImFsZyI6IlJTMjU2In0...\n```\n\n## Usage\n\n### With Claude Code\n\n1. Configure the MCP server in Claude Code settings (see installation section)\n2. Restart Claude Code\n3. Your Bedrock-hosted MCP tools will be available in Claude Code\n\n### Command Line\n\n```bash\n# Run directly\nopsguide-mcp\n\n# Run with uvx\nuvx opsguide-mcp\n\n# Run with environment variable\nAPI_KEY=\"your-bearer-token\" opsguide-mcp\n```\n\n## How It Works\n\n1. **Startup**: The proxy server reads your environment variables\n2. **Connection**: Establishes HTTP connection to Bedrock AgentCore Runtime\n3. **Discovery**: Lists available tools, resources, and prompts from your MCP server\n4. **Proxying**: Forwards all MCP requests from Claude Code to Bedrock AgentCore\n5. **Response**: Returns results back to Claude Code via stdio\n\n## Troubleshooting\n\n### Common Issues\n\n**Connection Failed**\n- Verify your `API_KEY` is correct and not expired\n- Check that your Bedrock AgentCore runtime is running\n- Ensure you have network access to bedrock-agentcore.us-east-1.amazonaws.com\n\n**No Tools Available**\n- Check that your MCP server is properly deployed in Bedrock AgentCore\n- Verify the runtime is in \"DEFAULT\" qualifier state\n- Check logs for connection errors\n\n**Authentication Errors**\n- Ensure your API_KEY (bearer token) is valid and not expired\n- Verify the token has permission to invoke the specified runtime\n\n### Debug Mode\n\nRun with debug logging:\n\n```bash\nPYTHONPATH=. python -m bedrock_mcp_proxy.server\n```\n\n## Development\n\n### Local Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-username/opsguide-mcp\ncd opsguide-mcp\n\n# Install dependencies\nuv sync\n\n# Run locally\nuv run opsguide-mcp\n```\n\n### Testing\n\n```bash\n# Test the connection\npython test_connection.py\n```\n\n## Security Considerations\n\n- **API Keys**: Store API keys securely using environment variables or secure credential management\n- **Network Access**: The proxy requires outbound HTTPS access to AWS Bedrock AgentCore\n- **Authentication**: Bearer tokens should be rotated regularly\n- **Logging**: Be careful not to log sensitive information\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Support\n\nFor issues related to:\n- **This proxy**: Open an issue on this repository\n- **Bedrock AgentCore**: Consult AWS documentation\n- **Claude Code**: Check Claude Code documentation",
"bugtrack_url": null,
"license": null,
"summary": "MCP Server proxy for Amazon Bedrock AgentCore Runtime",
"version": "0.1.4",
"project_urls": null,
"split_keywords": [
"ai",
" bedrock",
" mcp",
" opsguide",
" proxy"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "290fe50607a3c243cc605a8783ae19e5fcd46cb2be0b66ac1b3a4600f98267cf",
"md5": "23bf244f29b3942140f03233387057a7",
"sha256": "f7641832e656c753243a9a1d33aa36a0ed1341d7ebff667104c75d87e617b110"
},
"downloads": -1,
"filename": "opsguide_mcp-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "23bf244f29b3942140f03233387057a7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 6844,
"upload_time": "2025-09-13T02:59:20",
"upload_time_iso_8601": "2025-09-13T02:59:20.369034Z",
"url": "https://files.pythonhosted.org/packages/29/0f/e50607a3c243cc605a8783ae19e5fcd46cb2be0b66ac1b3a4600f98267cf/opsguide_mcp-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "22ff374d2f0737d3bed52f133aeef07467bc16c085110ebe92b152246e4bd5b0",
"md5": "a4043eee85b9ec82a7e28d064c4244a6",
"sha256": "ebce728c853117cb0275722b14d836426d186c092274717f5a6e67b135332205"
},
"downloads": -1,
"filename": "opsguide_mcp-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "a4043eee85b9ec82a7e28d064c4244a6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 5272,
"upload_time": "2025-09-13T02:59:21",
"upload_time_iso_8601": "2025-09-13T02:59:21.662512Z",
"url": "https://files.pythonhosted.org/packages/22/ff/374d2f0737d3bed52f133aeef07467bc16c085110ebe92b152246e4bd5b0/opsguide_mcp-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-13 02:59:21",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "opsguide-mcp"
}
