riz/mcp-memory
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update workflow constraints, rules, and project documentation

Browse Source
This commit is contained in:
Riz Ashraf committed 2026-10-02 07:27:26 +01:00
1 parent 74ca0948c9
commit 83aa26634d
3 files changed
+35
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

instructions.md
+17
View File
@@ -127,3 +127,20 @@ To reduce token costs and eliminate exact-match string failures:
## 17. Tool Schema Discovery (Lazy Loading)
Antigravity automatically caches all MCP tool schemas to your disk to save tokens. Do **NOT** grep or search the Rust source code to find tool schemas or arguments. To understand a tool's arguments, directly read `~/.gemini/antigravity-cli/mcp/<server_name>/<tool_name>.json`. Do NOT guess arguments. ALWAYS read the schema if you are unfamiliar with a tool to prevent invalid argument errors.
## 18. Local Ollama LLM Handshake & Graceful Fallback
`mcp-memory-server` includes a native, compiled Rust client (`server/src/ollama.rs`) that interfaces directly with local Ollama hardware (e.g. `http://192.168.1.30:11434`).
- **Connection Handshake:** On startup and before executing LLM-enhanced tools, the server performs a **1.5-second health probe** (`GET /api/tags`).
- **Environment Variables:** `OLLAMA_URL`, `OLLAMA_CODER_MODEL` (`qwen2.5-coder:1.5b`), `OLLAMA_REASONING_MODEL` (`deepseek-r1:1.5b`), `OLLAMA_VISION_MODEL` (`qwen3-vl:2b`), and `OLLAMA_EMBED_MODEL` (`nomic-embed-text:latest`).
- **Synergistic Tool Enhancements:**
- **`log_code_change`**: Automatically uses `qwen2.5-coder:1.5b` to summarize architectural impact.
- **`log_error_fix`**: Automatically uses `deepseek-r1:1.5b` for root cause & solution extraction.
- **`read_clipboard`**: Automatically passes clipboard image bytes to `qwen3-vl:2b` for OCR/layout parsing.
- **`omni_search`**: Uses `nomic-embed-text` for dense vector search indexing.
- **Graceful Fallback Guarantee:** If Ollama is offline, unreachable, or times out (>1.5s), **no tool ever fails or throws an error.** Every tool automatically degrades gracefully to pure Rust execution and local `redb`/`Tantivy` storage.
## 19. Tool Discovery & WebSocket Handshake (`tools/list_changed`)
The server implements the full Model Context Protocol (MCP) JSON-RPC specification for tool discovery and live updates:
- **`tools/list` Endpoint:** Primary clients query this endpoint during initialization to discover all registered tools, schemas, and argument types.
- **Dynamic Handshake Notification (`notifications/tools/list_changed`):** When the backend server restarts or modifies its tool definitions, it broadcasts a WebSocket `notifications/tools/list_changed` JSON-RPC notification. Light stubs (`mcp-memory-stub`) automatically receive this event and refresh the host CLI's tool catalog in real time without disconnecting or restarting the CLI context.