Neo4j MCP Chainlit

Neo4j MCP Chainlit

site icon
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 数据库的交互式工具,旨在简化数据库查询过程,提高开发效率。

核心功能

  1. 自然语言查询:通过 Claude LLM 将自然语言转换为数据库查询。
  2. 交互式界面:使用 Chainlit 提供用户友好的 Web 界面。
  3. 数据库访问:通过 Neo4j MCP 协议直接访问数据库。
  4. 快速配置:支持快速设置和运行,便于演示和开发。

适用场景

  1. 数据库开发:简化复杂查询的编写过程。
  2. 数据分析:通过自然语言快速获取数据库中的信息。
  3. 教育演示:展示自然语言处理与数据库的结合应用。

工具列表

  1. Chainlit:提供 Web 界面,支持交互式聊天。
  2. Claude LLM:处理自然语言,生成数据库查询。
  3. Neo4j MCP:连接和查询 Neo4j 数据库。

常见问题解答

  1. 如何获取 Anthropic API Key:需要在 Anthropic 官网注册并获取 API Key。
  2. 如何配置 MCP 连接:在 Chainlit 界面中设置 MCP 连接,指定数据库 URL 和认证信息。

使用教程

使用依赖

  1. 克隆仓库:
git clone https://github.com/Abhid14/neo4j-mcp-chainlit.git
cd neo4j-mcp-chainlit
  1. 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

  1. 创建 Python 虚拟环境:
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  1. 安装依赖:
uv pip install -r requirements.txt
  1. 配置环境变量:
cp .env.example .env
  1. 添加 Anthropic API Key 到 .env 文件:
ANTHROPIC_API_KEY=your_api_key_here

调试方式

  1. 启动 Chainlit 应用:
chainlit run app.py -w
  1. 配置 MCP 连接:
  2. 在 Chainlit 界面中设置 MCP 连接。
  3. 使用示例 Neo4j 数据库: /path/to/uv/binary/uvx mcp-neo4j-cypher --db-url neo4j+s://demo.neo4jlabs.com --user recommendations --password recommendations

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。