Neo4j MCP Chainlit

@Abhid14

About Neo4j MCP Chainlit

A poc of Neo4j mcp server with Chainlit (MCP host) and Claude LLM (Anthropic) API

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "neo4j-mcp-chainlit": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Neo4j MCP Chainlit?

Neo4j MCP Chainlit is a proof-of-concept integration that combines the Neo4j MCP server, Chainlit as the MCP host, and the Anthropic Claude LLM to create an interactive web chat interface for querying Neo4j databases using natural language.

How to use Neo4j MCP Chainlit?

Clone the repository, install uv, create a Python virtual environment, install dependencies from requirements.txt, and set your ANTHROPIC_API_KEY in a .env file. Start the app with chainlit run app.py -w. Then configure an MCP connection inside the Chainlit interface: use stdio mode, name it neo4j-mcp-demo, and set the command to /path/to/uv/binary/uvx mcp-neo4j-cypher --db-url neo4j+s://demo.neo4jlabs.com --user recommendations --password recommendations.

Key features of Neo4j MCP Chainlit

Web chat interface powered by Chainlit
Natural language queries via Claude (Anthropic API)
Database access through Neo4j’s Model Context Protocol
Pre-configured sample Neo4j database (Movie Graph)
Proof-of-concept demonstrating MCP + LLM integration

Use cases of Neo4j MCP Chainlit

Query a Neo4j demo database using plain English (e.g., “What movies did Tom Hanks act in?”)
Explore relationships (actors, directors, movies) without writing Cypher
Prototype natural language interfaces for graph databases
Demonstrate how MCP servers connect with LLM hosts

FAQ from Neo4j MCP Chainlit

Do I need a Neo4j instance to run Neo4j MCP Chainlit?

No. The app connects to the public Neo4j demo database (demo.neo4jlabs.com) by default using the provided credentials.

What LLM does Neo4j MCP Chainlit use?

It uses Claude from Anthropic. You must provide your own ANTHROPIC_API_KEY.

How does the app connect to Neo4j?

It uses an MCP server (mcp-neo4j-cypher) running in stdio mode via uvx. The connection is configured inside the Chainlit UI.

Is Neo4j MCP Chainlit production-ready?

No, it is explicitly labeled as a proof of concept.

What runtime dependencies are required?

Python (with uv), the mcp-neo4j-cypher package, and an Anthropic API key. The project itself uses a standard Python virtual environment and a requirements.txt file.

Frequently asked questions

Do I need a Neo4j instance to run Neo4j MCP Chainlit?

No. The app connects to the public Neo4j demo database (`demo.neo4jlabs.com`) by default using the provided credentials.

What LLM does Neo4j MCP Chainlit use?

It uses Claude from Anthropic. You must provide your own `ANTHROPIC_API_KEY`.

How does the app connect to Neo4j?

It uses an MCP server (`mcp-neo4j-cypher`) running in stdio mode via `uvx`. The connection is configured inside the Chainlit UI.

Is Neo4j MCP Chainlit production-ready?

No, it is explicitly labeled as a proof of concept.

What runtime dependencies are required?

Python (with `uv`), the `mcp-neo4j-cypher` package, and an Anthropic API key. The project itself uses a standard Python virtual environment and a `requirements.txt` file.