# 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`
- `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/`.

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.

## Tests

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