Metadata-Version: 2.4
Name: gephi-mcp
Version: 1.3.1
Summary: MCP Server for controlling Gephi Desktop via remote API
Project-URL: Homepage, https://www.mattartz.me
Project-URL: Repository, https://github.com/MattArtzAnthro/gephi-ai
Author: Matt Artz
License: Apache-2.0
Keywords: claude,gephi,graph,mcp,network,visualization
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.10
Requires-Dist: defusedxml>=0.7.1
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# gephi-mcp

MCP server that bridges any [Model Context Protocol](https://modelcontextprotocol.io) client
to a running [Gephi Desktop](https://gephi.org) instance, exposing **79 tools** for graph
construction, statistics, community detection, layout, styling, filtering, and
publication-ready export.

It translates MCP tool calls into HTTP requests against the Gephi MCP plugin's local API
(`http://127.0.0.1:8080`). Each tool has a typed signature, so clients receive a precise
per-field JSON schema rather than an opaque blob.

This is the **MCP server** component of [gephi-ai](https://github.com/MattArtzAnthro/gephi-ai);
see the top-level repository for the Gephi plugin, the Claude Code plugin, and full docs.

## Install

No install needed with [uv](https://docs.astral.sh/uv/) — point your MCP client at:

```bash
uvx gephi-mcp
```

`uvx` fetches [`gephi-mcp` from PyPI](https://pypi.org/project/gephi-mcp/) on first run
and caches it. For a persistent `gephi-mcp` command on your `PATH` instead, use
`pipx install gephi-mcp` (or `pipx install .` from this directory). Avoid plain
`pip install -e .` inside a virtual environment: the command is then only visible on
that venv's `PATH`, and MCP clients launched outside your shell won't find it.

## Use

The Gephi MCP plugin must be installed and Gephi Desktop running first. Then point any MCP
client at the `gephi-mcp` command, e.g. for Claude Desktop:

```json
{ "mcpServers": { "gephi-mcp": { "command": "uvx", "args": ["gephi-mcp"] } } }
```

## Configuration

| Env var | Default | Purpose |
|---|---|---|
| `GEPHI_API_URL` | `http://127.0.0.1:8080` | Gephi plugin HTTP API base URL |
| `GEPHI_REQUEST_TIMEOUT` | `60.0` | Per-request timeout (seconds) |

## Development

```bash
pip install -e . pytest pytest-asyncio ruff
ruff check .
pytest -q
```

## License

Apache-2.0 — see the [repository LICENSE](https://github.com/MattArtzAnthro/gephi-ai/blob/main/LICENSE).
