78 lines
2.1 KiB
Markdown
78 lines
2.1 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`
|
|
- `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
|
|
```
|