# 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](https://github.com/Imprivata-MAM)
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](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/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](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):

```bash
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):

```bash
pip install -e ".[dev]"
```

Run the MCP server over stdio:

```bash
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](brief-mam-mcp-server.md) for
scope.

## Status

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