mcpField
N
Neo4j MCP Chainlit

Neo4j MCP Chainlit

Local
github.com/Abhid14AI & Agents0Updated 82w ago
Repository

About Neo4j MCP Chainlit

Neo4j MCP Chainlit is a proof of concept for querying Neo4j databases in a Chainlit chat interface using Claude. It demonstrates natural-language queries through Neo4j's MCP server.

Key features

  1. 01Interactive Chainlit chat interface
  2. 02Natural-language database queries
  3. 03Claude via Anthropic API
  4. 04Neo4j database access through MCP

Use cases

  1. 01Ask questions about the Neo4j Movie Graph
  2. 02Explore relationships among actors and directors
  3. 03Find films matching release-date criteria

MCP support

The Chainlit application acts as an MCP host and connects to Neo4j's MCP server for database access.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Neo4j MCP Chainlit

A proof of concept demonstrating integration between Neo4j MCP server with Chainlit (MCP host) and Claude LLM (Anthropic API).

Overview

This project creates an interactive chat interface to query Neo4j databases using natural language. It leverages:

  • Chainlit for the web interface
  • Neo4j's MCP (Model Context Protocol) for database access
  • Claude from Anthropic as the LLM for natural language understanding

Quick Start Guide

Prerequisites
  1. Clone the repository:
git clone https://github.com/Abhid14/neo4j-mcp-chainlit.git
cd neo4j-mcp-chainlit
  1. Install uv on your system:
curl -LsSf https://astral.sh/uv/install.sh | sh

For additional installation options, check the uv documentation.

Setup
  1. Create a Python virtual environment:
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  1. Install dependencies:
uv pip install -r requirements.txt
  1. Configure environment variables:
cp .env.example .env
  1. Add your Anthropic API key to the .env file:
ANTHROPIC_API_KEY=your_api_key_here
Running the Application

Start the Chainlit app:

chainlit run app.py -w
Configure MCP Connections
  1. In the Chainlit app interface, configure MCP connections
  2. Use the sample Neo4j database:
    • Set the MCP connection in stdio mode
    • Name it neo4j-mcp-demo
    • Set the Command to: 
      /path/to/uv/binary/uvx mcp-neo4j-cypher --db-url neo4j+s://demo.neo4jlabs.com --user recommendations --password recommendations

Demo

The application uses the Neo4j demo database (Movie Graph) to demonstrate natural language querying capabilities.

Try asking questions like:

  • "What movies did Tom Hanks act in?"
  • "Show me the relationship between actors and directors"
  • "Find all movies released after 2010"

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.