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:

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

Endpoint:

http://127.0.0.1:8765/mcp

Health:

http://127.0.0.1:8765/health

stdio transport

For clients that require stdio, launch:

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:

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:

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

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

2.1 KiB Raw Blame History