Gke Hub Api

🚀 MCP Server

This project offers an MCP (Model Context Protocol) Server tailored for the specified OpenAPI URL - https://api.apis.guru/v2/specs/googleapis.com/gkehub/v1beta1/openapi.json. It's auto - generated by AG2's MCP builder.

🚀 Quick Start

The MCP Server simplifies interactions with the given OpenAPI URL. You can set it up and start using it following the steps below.

✨ Features

• Auto - generated for a specific OpenAPI URL.
• Supports multiple transport modes.
• Configurable via environment variables.

📦 Installation

Prerequisites

• Python 3.9+
• pip and uv

Steps

1. Clone the repository:

   git clone <repository-url>
   cd mcp-server
   

2. Install dependencies: The .devcontainer/setup.sh script uses pip install -e ".[dev]" to install dependencies. If you're not using the dev container, run this command manually.

   pip install -e ".[dev]"
   

   Alternatively, use uv:

   uv pip install --editable ".[dev]"
   

💻 Usage Examples

Development

Linting and Formatting

To check for linting issues:

ruff check

To format the code:

ruff format

These commands are also available via the scripts/lint.sh script.

Static Analysis

To run static analysis (mypy, bandit, semgrep):

./scripts/static-analysis.sh

This script is configured as a pre - commit hook in .pre-commit-config.yaml.

Running Tests

To run tests with coverage:

./scripts/test.sh

This will run pytest and generate a coverage report. For a combined report and cleanup, use:

./scripts/test-cov.sh

Pre - commit Hooks

This project uses pre - commit hooks defined in .pre-commit-config.yaml. To install the hooks:

pre-commit install

The hooks will run automatically before each commit.

Running the Server

The MCP server can be started using the mcp_server/main.py script. It supports different transport modes (e.g., stdio, sse, streamable-http).

Basic Usage

To start the server (e.g., in stdio mode):

python mcp_server/main.py stdio

Configuration

The server can be configured using environment variables:

• CONFIG_PATH: Path to a JSON configuration file (e.g., mcp_server/mcp_config.json).
• CONFIG: A JSON string containing the configuration.
• SECURITY: Environment variables for security parameters (e.g., API keys).

Refer to the if __name__ == "__main__": block in mcp_server/main.py for details on how these are loaded.

The tests/test_mcp_server.py file demonstrates how to start and interact with the server programmatically for testing.

Building and Publishing

This project uses Hatch for building and publishing. To build the project:

hatch build

To publish the project:

hatch publish

These commands are also available via the scripts/publish.sh script.