Skip to content

feat: engraph v0.5.0 — MCP server#6

Merged
devwhodevs merged 3 commits intomainfrom
feature/v2.2b
Mar 24, 2026
Merged

feat: engraph v0.5.0 — MCP server#6
devwhodevs merged 3 commits intomainfrom
feature/v2.2b

Conversation

@devwhodevs
Copy link
Copy Markdown
Owner

Summary

MCP stdio server exposing engraph's vault intelligence as 7 read-only tools. Any MCP client (Claude Code, etc.) can connect and search, read, and query the vault.

New command

engraph serve    # Start MCP stdio server

MCP Tools

Tool Description
search Hybrid 3-lane search (semantic + FTS5 + graph)
read Full note content with metadata and graph edges
list Filter notes by folder and/or tags
vault_map Vault structure overview for agent orientation
who Person context bundle (note + mentions + links)
project Project context bundle (note + children + tasks + team)
context Rich topic context with character budget trimming

Claude Code integration

{
  "mcpServers": {
    "engraph": {
      "command": "engraph",
      "args": ["serve"]
    }
  }
}

Architecture

  • rmcp v1.2 (official Rust MCP SDK) with stdio transport
  • EngraphServer struct with Arc<Mutex<>> wrapping for async compatibility
  • #[tokio::main] async main — all existing sync commands unaffected
  • Resources loaded once at startup (Store, Embedder, HNSW, profile)
  • All tools return JSON via CallToolResult::success

Test plan

  • 146 unit tests passing
  • Clippy clean
  • Formatted
  • Server starts and prints MCP startup message
  • Manual: configure in Claude Code settings, test tool calls
  • Manual: engraph serve responds to MCP initialize handshake

🤖 Generated with Claude Code

devwhodevs and others added 3 commits March 25, 2026 00:36
Prepare for MCP server: add dependencies, make main async with
tokio::main, add Serve command. InternalSearchResult derives Serialize.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
EngraphServer with search, read, list, vault_map, who, project,
context tools. Arc+Mutex wrapping for rmcp Clone requirement.
tokio::sync::Mutex for Store and Embedder. All tools return JSON.
Server loads all resources at startup, serves until EOF.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
14 modules, 146 tests. MCP stdio server exposing 7 vault
intelligence tools for AI agent access.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@devwhodevs devwhodevs merged commit 0be5225 into main Mar 24, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant