How vmikhailov/cypher-mcp works
Cypher MCP is an embedded SQLite knowledge-graph server and standalone CLI for AI agents and developers. The main workflow is an agent sending OpenCypher or graph-tool requests over MCP, followed by query execution against the local graph and structured results; users can also manage the graph with the CLI. The product additionally supports graph mutations, schema governance, full-text search, and vector-based entity resolution. The README documents the main product capabilities; some internal package relationships are omitted where the excerpts do not show their callers.
Main entry points: storage.go SQLite Store · execute.go Tool Executor · main.go MCP Server · mutate.go Graph Mutations
Components 15
User Interfaces
- MCP Server
cmd/cypher-mcp/main.go - Standalone CLI
cmd/cypher-mcp/cli.go - Tool Definitions
internal/transport/specs.go - Tool Executor
internal/transport/execute.go
Graph Operations
- Cypher Queries
internal/graph/query.go - Graph Mutations
internal/graph/mutate.go - Schema Governance
internal/graph/schema.go - Graph Validation
internal/graph/validate.go - Full-Text Search
internal/graph/search.go - Graph Models
internal/graph/models.go
Persistence
- SQLite Store
internal/storage/storage.go
Entity Resolution
- Vector Resolution
internal/vector/vector.go - Vector Tool Handlers
cmd/cypher-mcp/vector.go - MetaQA Indexer
scripts/index_metaqa.py
Other components
- AI Agent
Connections 14
- AI Agent → MCP Server: sends MCP requests
README.md - MCP Server → Standalone CLI: dispatches CLI mode
cmd/cypher-mcp/main.go - MCP Server → SQLite Store: uses embedded SQLite
README.md - Tool Definitions → Tool Executor: defines tools
- Tool Executor → Cypher Queries: executes queries
internal/transport/execute.go - Tool Executor → Vector Resolution: resolves entities
internal/transport/execute.go - Tool Executor → Graph Mutations: upserts graph
internal/transport/execute.go - Cypher Queries → SQLite Store: queries SQLite
internal/graph/query.go - Graph Mutations → Graph Validation: validates changes
internal/graph/mutate.go - Graph Mutations → Schema Governance: checks schema
internal/graph/mutate.go - Full-Text Search → SQLite Store: searches index
internal/graph/search.go - Vector Resolution → SQLite Store: reads embeddings
internal/vector/vector.go - Vector Tool Handlers → Vector Resolution: handles vector tools
- MetaQA Indexer → SQLite Store: builds graph database