# AIW Context MCP

Read-only local Model Context Protocol server for AI Workspace context.

The server exposes bounded local evidence and canonical Markdown context to MCP clients. It does not capture traffic, send messages, mutate files, or promote memory.

## HTTP transport

The service manager starts the HTTP transport by default:

```bash
python3 scripts/aiw/services.py start aiw-context-mcp --profile fidelity
```

Endpoint:

```text
http://127.0.0.1:8765/mcp
```

Health:

```text
http://127.0.0.1:8765/health
```

## stdio transport

For clients that require stdio, launch:

```bash
python3 scripts/mcp/aiw-context-mcp/server.py --transport stdio
```

## Tools

- `context_profiles`
- `communication_latest`
- `communication_date_context`
- `communication_standup_context`
- `communication_channel_context`
- `communication_thread_context`
- `project_current_context`
- `project_search_memory`
- `memory_hybrid_search`
- `photos_latest`

All tools are read-only. Mattermost tools read `ai/inbox/mattermost-mirror/`; photo tools list local Photo Inbox files without embedding image data; project tools read canonical Markdown under `project-knowledge/`.

`memory_hybrid_search` reads the derived local index built by:

```bash
python3 scripts/aiw/indexer.py build --profile fidelity
```

If the index is missing, it falls back to bounded live Markdown search over `project-knowledge/`. The index is not canonical memory; `project-knowledge/` remains the source of truth.

Mattermost latest/date/standup tools filter to the active profile's context channels by default. For Fidelity, that list lives in `profiles/fidelity/context-sources.json`. Pass explicit `channels` to override the profile list, or `include_all_channels: true` when broad unfiltered mirror evidence is intentionally needed.

## Resources

The server also exposes profile resources such as:

```text
aiw://profiles/fidelity/current-work
aiw://profiles/fidelity/work-items
aiw://profiles/fidelity/mattermost/latest
aiw://profiles/fidelity/photos/latest
```

See `client-configs.md` for client setup snippets and verification prompts.

## Tests

```bash
python3 scripts/mcp/aiw-context-mcp/test_server.py
```