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 數據庫。用戶可按照上述快速開始部分的步驟進行操作，體驗自然語言查詢數據庫的便捷性。