FastMCP server that exposes HugeGraph schema & Gremlin tools over MCP/STDIO
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"hugegraph-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# HugeGraph MCP [中文文档](README.zh-CN.md) HugeGraph MCP is a safe, controlled Model Context Protocol adapter for HugeGraph Server. It exposes stable structured tools, centralizes configuration and permission checks, and persists immutable write plans and outcomes. **Requires HugeGraph Server >= 1.7.0.** The default graph path is `DEFAULT/hugegraph` and uses graphspace-scoped APIs unavailable in older releases. ## Quick Start Installing a published package does not require cloning this repository. The commands below target `1.7.1` on PyPI; until it is published, use the [developer setup](#developer-notes). See the [release workflow](docs/releasing.md). Install [uv](https://docs.astral.sh/uv/getting-started/installation/), then start the server in read-only mode: ```bash export HUGEGRAPH_URL=http://hugegraph.example.com:8080 export HUGEGRAPH_GRAPH_PATH=DEFAULT/hugegraph export HUGEGRAPH_USER=admin export HUGEGRAPH_PASSWORD=admin export HUGEGRAPH_MCP_READONLY=true uvx [email protected] ``` The process speaks MCP JSON-RPC on stdout. Keep `HUGEGRAPH_MCP_READONLY=true` unless controlled writes are required. The default toolset is `v2_core`; set `HUGEGRAPH_MCP_TOOLSET=v1` before startup only for the legacy 10-tool contract. For MCP clients that accept JSON server configuration: ```json { "mcpServers": { "hugegraph": { "command": "uvx", "args": ["[email protected]"], "env": { "HUGEGRAPH_URL": "http://hugegraph.example.com:8080", "HUGEGRAPH_GRAPH_PATH": "DEFAULT/hugegraph", "HUGEGRAPH_USER": "admin", "HUGEGRAPH_PASSWORD": "admin", "HUGEGRAPH_MCP_READONLY": "true" } } } } ``` ## Developer Notes To try both packages from the same checkout, run from the repository root: ```bash uvx --no-config --no-cache --with ./hugegraph-python-client --from ./hugegraph-mcp hugegraph-mcp ``` From the root of the PR checkout, install uv, then create an isolated environment and install both packages fr…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.