Files
fidelity-ai-workspace/scripts/mcp/aiw-context-mcp/README.md

56 lines
1.5 KiB
Markdown

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