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 ドキュメントを参照してください。

セットアップ

1. Python 仮想環境を作成します：

uv venv
source .venv/bin/activate  # Windows の場合：.venv\Scripts\activate

2. 依存関係をインストールします：

uv pip install -r requirements.txt

3. 環境変数を設定します：

cp .env.example .env

4. .env ファイルにあなたの Anthropic API キーを追加します：

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 で Web インターフェースを提供
• Neo4j の MCP（モデルコンテキストプロトコル）を使用してデータベースにアクセス
• Anthropic の Claude を LLM として使用して自然言語を理解

📚 ドキュメント

デモ

このアプリケーションは、Neo4j のサンプルデータベース（映画グラフ）を使用して、自然言語クエリ機能をデモンストレーションします。以下のような質問を試してみてください：

• “トム・ハンクスが出演した映画はどれですか？”
• “俳優と監督の関係を表示してください”
• “2010 年以降に公開されたすべての映画を見つけてください”