Metadata-Version: 2.4
Name: llmgraph-mcp
Version: 0.2.0
Summary: Official Model Context Protocol (MCP) server for LLMGRAPH semantic code intelligence
Author-email: Brainfoods Studio <founders@llmgraph.in>
License: Apache-2.0
Project-URL: Homepage, https://llmgraph.in
Project-URL: Documentation, https://llmgraph.in/docs
Project-URL: Repository, https://github.com/hurtxlocker-lab/llmgraph-mcp.git
Project-URL: Issues, https://github.com/hurtxlocker-lab/llmgraph-mcp/issues
Keywords: mcp,model-context-protocol,llmgraph,code-intelligence,call-graph,claude,cursor,windsurf
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0

# llmgraph-mcp

Official Model Context Protocol (MCP) server for LLMGRAPH semantic code intelligence.

Provides 10 curated client tools powered by the 19-tool LLMGRAPH engine kernel.

## Overview

`llmgraph-mcp` connects AI coding assistants directly to hosted, persistent repository code intelligence. Instead of burning model context re-reading thousands of files or guessing caller hierarchies, LLMGRAPH delivers deterministic answers with verified certainty:

- **10 Curated Client Tools**:
  - **Spatial Traversal**: `get_callers`, `get_impact`, `get_path`, `get_dependency_hubs`
  - **Lifecycle Management**: `connect_repository`, `sync_repository`, `repository_status`, `list_repositories`, `delete_repository`, `search_symbols`

## Quickstart

Run directly with `uvx` (recommended):

```bash
uvx llmgraph-mcp
```

Or install via `pip`:

```bash
pip install llmgraph-mcp
```

*(Compatibility note: `trishul-mcp` and `llmgraph-in` are maintained as backward-compatibility forwarders).*

## MCP Client Configuration

### Claude Desktop / Claude Code

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "llmgraph": {
      "command": "uvx",
      "args": ["llmgraph-mcp"],
      "env": {
        "LLMGRAPH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

### Cursor / Windsurf

Configure command as `uvx llmgraph-mcp` with `LLMGRAPH_API_KEY`.

### Environment Variables

| Variable | Description | Default |
| :--- | :--- | :--- |
| `LLMGRAPH_API_KEY` | Your LLMGRAPH API key (**required**) | None |
| `LLMGRAPH_API_URL` | Custom engine endpoint | `https://api.llmgraph.in/v1` |
| `LLMGRAPH_GITHUB_TOKEN` | Optional token for private GitHub repositories | None |

*(Note: `TRISHUL_API_KEY` and `TRISHUL_API_URL` are recognized for backward compatibility).*

## License

Apache-2.0. Developed by Brainfoods Studio.
