Metadata-Version: 2.4
Name: graphe-mcp
Version: 0.1.1
Summary: MCP server for connecting AI tools to the Graphe API
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: graphe-sdk>=0.1.1
Requires-Dist: mcp>=1.2.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"

# graphe-mcp

Model Context Protocol (stdio) server for [Graphe](https://graphe.dev). Connect Cursor, Claude Desktop, and other MCP hosts to your Graphe workspace.

## Install

```bash
pip install graphe-mcp
```

## Configuration

Set environment variables (or pass them in your MCP host config):

| Variable | Purpose |
|----------|---------|
| `GRAPHE_API_BASE` | API URL |
| `GRAPHE_API_KEY` | API key from the Graphe console |
| `GRAPHE_WORKSPACE_ID` | Workspace scope |
| `GRAPHE_PROJECT_ID` | Project scope |

Example `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "graphe": {
      "command": "graphe-mcp",
      "env": {
        "GRAPHE_API_BASE": "https://api.yourdomain.com",
        "GRAPHE_API_KEY": "graphe_live_...",
        "GRAPHE_WORKSPACE_ID": "...",
        "GRAPHE_PROJECT_ID": "..."
      }
    }
  }
}
```

## Run

```bash
graphe-mcp
```

In your MCP host, call `graphe_health` to verify connectivity.

## Tools

Read tools include current state, hybrid search, runs, claims, and entities. Write tools are limited to safe ingestion (`graphe_create_run`, `graphe_log_event`, `graphe_create_annotation`) with required idempotency keys. Claim lifecycle mutations are CLI-only.

Full tool list: [MCP documentation](https://github.com/ShauryaVM/KG-Idea/blob/main/docs/mcp.md).
