feat: implement AI Workspace context MCP server with read-only access and add related tests
This commit is contained in:
53
scripts/mcp/aiw-context-mcp/README.md
Normal file
53
scripts/mcp/aiw-context-mcp/README.md
Normal file
@@ -0,0 +1,53 @@
|
||||
# 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/`.
|
||||
|
||||
## Tests
|
||||
|
||||
```bash
|
||||
python3 scripts/mcp/aiw-context-mcp/test_server.py
|
||||
```
|
||||
Reference in New Issue
Block a user