adp-mcp 0.1.0.dev0

ADP MCP Bridge: Expose ADP Hypervisor resources as MCP tools

adp-mcp

ADP MCP Bridge — an MCP server that exposes ADP Hypervisor resources as MCP tools, enabling LLM agents to discover, describe, validate, and execute ADP intents.

Tools

Tool	Description
adp_discover	List available ADP resources, with optional filters by domain, intent class, or keyword
adp_describe	Get the usage contract (field schema, predicates, projections) for a resource + intent class
adp_validate	Validate an intent IR against a resource schema without executing it
adp_execute	Execute an ADP intent and return results (supports pagination via cursor)

Installation

pip install adp-mcp

Usage

adp-mcp --config /path/to/adp/manifest [--log-level INFO]

Logs are written to stderr. To redirect them to a file, use shell redirection:

adp-mcp --config /path/to/adp/manifest 2>/path/to/adp-mcp.log

Authentication

Set environment variables for Basic Auth:

export ADP_USERNAME=myuser
export ADP_PASSWORD=mypassword

If ADP_USERNAME is not set, the server connects anonymously.

MCP Client Configuration

{
  "mcpServers": {
    "adp": {
      "command": "adp-mcp",
      "args": ["--config", "/path/to/adp/manifest"]
    }
  }
}

Docker Quickstart

The docker/ directory contains a self-contained Docker Compose stack that starts all backend dependencies and a prepared mcp-runtime container. This is the fastest way to try ADP MCP without installing anything locally.

cd adp-mcp/docker
docker compose up -d

See docker/README.md for the full setup guide and MCP client configuration.

Development

cd adp-mcp
uv sync --extra dev
uv run python -m unittest discover -s tests -v