home / mcp / hubapiomauth mcp server

Hubapiomauth MCP Server

Provides an MCP endpoint to interact with Hub API authentication flows via a standardized server interface.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ag2-mcp-servers-hubapicomauth": {
      "command": "python",
      "args": [
        "mcp_server/main.py",
        "stdio"
      ],
      "env": {
        "CONFIG": "A JSON string containing the configuration.",
        "SECURITY": "Environment variables for security parameters (e.g., API keys).",
        "CONFIG_PATH": "Path to a JSON configuration file (e.g., mcp_server/mcp_config.json)"
      }
    }
  }
}

You run an MCP server that exposes the OpenAPI-based Model Context Protocol interface for hubapi.com/auth/v1. It enables your clients to access and manipulate API models with context-aware RPC calls, suitable for tooling, automation, and integration workflows.

How to use

You start the MCP server in a local process and connect your MCP client to it. Use the stdio transport to run the server directly from your development environment, which keeps you within the same process space as your tooling. Once running, your client can request the server’s capabilities, access the OpenAPI-described endpoints, and perform context-aware RPC operations against the hubapi.com/auth/v1 specification.

How to install

Prerequisites: ensure you have Python 3.9 or newer, and a working Python package manager.

Install Python dependencies and development tools as needed for MCP development and testing.

Step by step commands to set up and run the MCP server locally:

# 1. Install dependencies
pip install -e ".[dev]"

# Alternatively, install via uv (if you prefer running under uv):
uv pip install --editable ".[dev]"

# 2. Run the MCP server in stdio mode
python mcp_server/main.py stdio

Additional notes

Configuration and security are handled via environment variables. You can point the server to a JSON configuration file or pass a JSON string directly. The following environment variables are commonly used: CONFIG_PATH for the path to a configuration file, CONFIG for a JSON string containing the configuration, and SECURITY for security-related parameters such as API keys.

Configuration and starting commands

To start the server with explicit configuration from the command line, you can run the following command for stdio transport:

python mcp_server/main.py stdio

Available tools

lint

Run linting to find code quality issues using Ruff.

format

Format code with Ruff to ensure consistent styling.

static-analysis

Perform static analysis including mypy, bandit, and semgrep via a dedicated script.

test

Execute unit tests with pytest and generate coverage reports.

pre-commit

Install and run pre-commit hooks to enforce quality before commits.