chp-adapter-mcp

The inbound MCP bridge for the Capability Host Protocol. Connects to an external Model Context Protocol server, discovers its tools, and registers each one as a governed CHP capability (chp.adapters.mcp.<server>.<tool>) with full execution evidence.

This complements the TypeScript outbound bridges (@auxo/chp-runtime-mcp), which expose CHP capabilities as MCP tools. Together they make CHP and MCP interoperate in both directions:

outbound (TS): CHP capability → MCP tool
inbound (this package): MCP tool → CHP capability

Install

pip install chp-adapter-mcp

Usage

from chp_core import LocalCapabilityHost, register_adapter
from chp_adapter_mcp import MCPAdapter, MCPServerConfig

host = LocalCapabilityHost()
adapter = MCPAdapter(MCPServerConfig(
    name="filesystem",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
))
register_adapter(host, adapter)

# Every tool the server exposes is now a CHP capability:
result = host.invoke("chp.adapters.mcp.filesystem.read_file", {"path": "/tmp/x"})

The MCP tool's own JSON Schema becomes the capability input_schema, so chp-core validates arguments before the tool runs and emits a full evidence chain (execution_started → mcp_tool_called → mcp_tool_result → execution_completed, or execution_failed).

Design notes

Each MCPAdapter owns one MCP server connection on a dedicated background thread + event loop (_ThreadedMCPSession), because the host runs handlers via asyncio.run (a fresh loop per call) and an MCP session is loop-bound.
The session is abstracted behind a small protocol so it can be faked in tests without spawning a subprocess.
MCPAdapter requires a server config, so register it manually with register_adapter(host, MCPAdapter(config)). It is also declared under the chp.adapters entry-point group for discovery/introspection.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

chp_adapter_mcp-0.23.0-py3-none-any.whl (6.3 kB view details)

Uploaded Jul 12, 2026 Python 3

File details

Details for the file chp_adapter_mcp-0.23.0-py3-none-any.whl.

File metadata

Download URL: chp_adapter_mcp-0.23.0-py3-none-any.whl
Upload date: Jul 12, 2026
Size: 6.3 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for chp_adapter_mcp-0.23.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`a1a1dfcd2059169aef8a643ec548df5fc76a8ba0d2efb166fd2718d4fe7fa553`
MD5	`9c151d3c37cf3e338f9c1c3ce230006f`
BLAKE2b-256	`fadb05203897bbaa73a063b94c9f32a4ea17859ce40ada05c99c113984f4b5e0`