Metadata-Version: 2.4
Name: mcp-graph-engine
Version: 1.0.1
Summary: A graph database and analysis tool for AI assistants via MCP
Author: utilitydelta
Maintainer: utilitydelta
License: MIT
Project-URL: Homepage, https://github.com/utilitydelta/mcp-graph-engine
Project-URL: Documentation, https://github.com/utilitydelta/mcp-graph-engine#readme
Project-URL: Repository, https://github.com/utilitydelta/mcp-graph-engine.git
Project-URL: Issues, https://github.com/utilitydelta/mcp-graph-engine/issues
Project-URL: Changelog, https://github.com/utilitydelta/mcp-graph-engine/blob/main/CHANGELOG.md
Keywords: mcp,graph,knowledge-graph,llm,ai-assistant,networkx,cypher
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Database :: Database Engines/Servers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=0.9.0
Requires-Dist: networkx>=3.0
Requires-Dist: numpy<2,>=1.24.0
Requires-Dist: scipy>=1.10.0
Requires-Dist: pydot>=1.4.0
Requires-Dist: grand-cypher>=0.3.0
Requires-Dist: fastapi>=0.100.0
Requires-Dist: uvicorn>=0.24.0
Requires-Dist: websockets>=11.0
Provides-Extra: embeddings
Requires-Dist: sentence-transformers>=2.2.0; extra == "embeddings"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Dynamic: license-file

# MCP Graph Engine

A graph database for AI assistants via the Model Context Protocol. Build relationship graphs, run analysis algorithms, and visualize in real-time.

<img alt="image" src="docs/assets/screenshot.png" />

## Installation

**Requirements:** Python 3.10+, MCP-compatible client (Claude Code, Claude Desktop, Cursor)

```bash
pipx install mcp-graph-engine
```

Add to your MCP config:

```json
{
  "mcpServers": {
    "graph-engine": {
      "command": "mcp-graph-engine"
    }
  }
}
```

| Client | Config Location |
|--------|-----------------|
| Claude Code | `~/.mcp.json` or `.mcp.json` |
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Cursor | `.cursor/mcp.json` |

Restart your client after adding the config.

## What You Can Do

Just ask your AI assistant:

- "Map out the dependencies in this codebase"
- "Build a graph of the characters in this document"
- "What's the most critical component?"
- "Are there any circular dependencies?"
- "Show me the path from X to Y"
- "Visualize the graph"

The AI handles the tool calls. You get a live visualization at `http://localhost:8765`.

## Features

- **Analysis** - PageRank, cycle detection, shortest paths, connected components
- **Visualization** - Live D3 force-directed graph in your browser
- **Import/Export** - DOT, CSV, GraphML, JSON, Mermaid

## Configuration

| Variable | Default | Description |
|----------|---------|-------------|
| `VIS_PORT` | `8765` | Visualization server port |
| `VIS_HOST` | `localhost` | Visualization server host |
| `VIS_ENABLED` | `true` | Enable/disable visualization |

## Notes

- **Transient** - Graphs live in memory. Export to JSON for persistence.
- **Fuzzy matching** - `pipx install mcp-graph-engine[embeddings]` for semantic node matching.

## License

MIT
