
Neo4j MCP Chainlit

2025.04.07
0
Python自然语言查询数据库访问交互式界面数据库开发效率
Neo4j MCP Chainlit 是一个概念验证项目,展示了 Neo4j MCP 服务器与 Chainlit(MCP 主机)和 Claude LLM(Anthropic API)的集成。该项目创建了一个交互式聊天界面,允许用户使用自然语言查询 Neo4j 数据库。主要功能包括利用 Chainlit 提供 Web 界面,通过 Neo4j 的 MCP(Model Context Protocol)访问数据库,以及使用 Anthropic 的 Claude 作为自然语言理解的 LLM。
View on GitHub
Overview
基本能力
产品定位
Neo4j MCP Chainlit 是一个用于自然语言查询 Neo4j 数据库的交互式工具,旨在简化数据库查询过程,提高开发效率。
核心功能
- 自然语言查询:通过 Claude LLM 将自然语言转换为数据库查询。
- 交互式界面:使用 Chainlit 提供用户友好的 Web 界面。
- 数据库访问:通过 Neo4j MCP 协议直接访问数据库。
- 快速配置:支持快速设置和运行,便于演示和开发。
适用场景
- 数据库开发:简化复杂查询的编写过程。
- 数据分析:通过自然语言快速获取数据库中的信息。
- 教育演示:展示自然语言处理与数据库的结合应用。
工具列表
- Chainlit:提供 Web 界面,支持交互式聊天。
- Claude LLM:处理自然语言,生成数据库查询。
- Neo4j MCP:连接和查询 Neo4j 数据库。
常见问题解答
- 如何获取 Anthropic API Key:需要在 Anthropic 官网注册并获取 API Key。
- 如何配置 MCP 连接:在 Chainlit 界面中设置 MCP 连接,指定数据库 URL 和认证信息。
使用教程
使用依赖
- 克隆仓库:
git clone https://github.com/Abhid14/neo4j-mcp-chainlit.git
cd neo4j-mcp-chainlit
- 安装
uv
:
curl -LsSf https://astral.sh/uv/install.sh | sh
安装教程
- 创建 Python 虚拟环境:
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
- 安装依赖:
uv pip install -r requirements.txt
- 配置环境变量:
cp .env.example .env
- 添加 Anthropic API Key 到
.env
文件:
ANTHROPIC_API_KEY=your_api_key_here
调试方式
- 启动 Chainlit 应用:
chainlit run app.py -w
- 配置 MCP 连接:
- 在 Chainlit 界面中设置 MCP 连接。
- 使用示例 Neo4j 数据库:
/path/to/uv/binary/uvx mcp-neo4j-cypher --db-url neo4j+s://demo.neo4jlabs.com --user recommendations --password recommendations