自然语言数据库查询工具

Neo4j MCP Chainlit

概念验证演示了Neo4j MCP服务器与Chainlit（MCP主机）和Claude LLM（Anthropic API）之间的集成。

概述

该项目创建了一个交互式聊天界面，使用自然语言查询Neo4j数据库。它利用了：

• Chainlit用于web界面
• Neo4j的MCP（模型上下文协议）用于数据库访问
• Claude from Anthropic担任自然语言理解法学硕士

快速入门指南

先决条件

1. 克隆存储库：

git clone https://github.com/Abhid14/neo4j-mcp-chainlit.git
cd neo4j-mcp-chainlit

2. 安装 uv 在您的系统上：

curl -LsSf https://astral.sh/uv/install.sh | sh

有关其他安装选项，请查看 紫外线文件.

设置

1. 创建Python虚拟环境：

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. 安装依赖项：

uv pip install -r requirements.txt

3. 配置环境变量：

cp .env.example .env

4. 将您的Anthropic API密钥添加到 .env 文件：

ANTHROPIC_API_KEY=your_api_key_here

运行应用程序

启动Chainlit应用程序：

chainlit run app.py -w

配置MCP连接

1. 在Chainlit应用程序界面中，配置MCP连接
2. 使用示例Neo4j数据库：
   • 将MCP连接设置为stdio模式
   • 说出它的名字 neo4j-mcp-demo
   • 将命令设置为：
     复制

     /path/to/uv/binary/uvx mcp-neo4j-cypher --db-url neo4j+s://demo.neo4jlabs.com --user recommendations --password recommendations
     

演示

该应用程序使用Neo4j演示数据库（Movie Graph）来演示自然语言查询功能。

试着问以下问题：

• “汤姆·汉克斯演过什么电影？”
• “让我看看演员和导演之间的关系”
• “查找2010年以后上映的所有电影”