MAM MCP Context Service

An MCP (Model Context Protocol) server that provides queryable context about the Mobile Access Management (MAM) product — the MAM Server, Ground Control Launchpad, and GroundControl Locker components, their integrations, and overall architecture.

Why

The MAM product is highly technical and deeply integrated across components and third-party/OS-level hooks. The existing MAM_KT_2 mkdocs knowledge base captures this well, but is too heavyweight for an agent to consume directly during an agentic development session — the only current option is indexing the entire doc tree into local memory, which is expensive and doesn't scale.

This service uses the OKF framework as a structural reference to build a metadata/service layer over the MAM_KT_2 knowledge base, exposing it through MCP so agentic tools (initially Claude) can query targeted product context on demand instead of loading the full doc tree.

See brief-mam-mcp-server.md for the product brief.

Setup

This service reads content from the MAM_KT_2 knowledge base at runtime. Symlink your local MAM_KT_2 checkout into the project root (the symlink is gitignored):

ln -s /path/to/MAM_KT_2 MAM_KT_2

No environment variables are required if the symlink is present. To point at a different location instead, set MAM_KT_2_ROOT, or override MAM_SERVER_DETAIL_DIR and MAM_SERVER_OVERVIEW_DIR directly.

Running the server

Install the package (in a virtualenv):

pip install -e ".[dev]"

Run the MCP server over stdio:

python -m mam_mcp

Point an MCP-aware client (e.g. Claude) at this command as a stdio server. The server exposes a single query tool backed by retrieval over the MAM Server documentation corpus — see brief-mam-mcp-server.md for scope.

Status

story-001 (single-component query, MAM Server) shipped. See slices/ for what's next.