Neo4j MCP Chainlit

🚀 用于 Chainlit 的 Neo4j MCP

本项目是一个概念验证项目，旨在演示 Neo4j MCP 服务器与 Chainlit（MCP 主机）以及 Claude LLM（Anthropic API）的集成。借助该项目，用户可通过自然语言查询 Neo4j 数据库，为数据库交互提供了更便捷的方式。

🚀 快速开始

先决条件

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

有关其他安装选项，请参阅 uv 文档。

📦 安装指南

创建 Python 虚拟环境

uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

安装依赖项

uv pip install -r requirements.txt

配置环境变量

cp .env.example .env

添加 Anthropic API 密钥

将你的 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 数据库。它结合了以下技术：

• Chainlit：提供网络界面，方便用户与系统进行交互。
• Neo4j 的 MCP（模型上下文协议）：用于数据库访问，实现自然语言到数据库查询的转换。
• Anthropic 的 Claude：作为 LLM 进行自然语言理解，准确解析用户的自然语言问题。

💻 使用示例

基础用法

该应用程序使用 Neo4j 示例数据库（电影图）来演示自然语言查询功能。你可以尝试提出以下问题：

“汤姆·汉克斯演了哪些电影？”

“显示演员和导演之间的关系”

“找出所有在 2010 年之后上映的电影”

📚 详细文档

本项目主要用于演示 Neo4j MCP 服务器与 Chainlit 以及 Claude LLM 的集成，通过自然语言查询 Neo4j 数据库。用户可按照上述快速开始部分的步骤进行操作，体验自然语言查询数据库的便捷性。