Neo4j MCP Chainlit

Neo4j MCP Chainlit

Neo4j MCP サーバーと Chainlit（MCP ホスト）、Claude LLM（Anthropic API）の連携を実証する概念実証です。

概要

このプロジェクトでは、自然言語を使って Neo4j データベースに問い合わせるための、対話型チャットインターフェースを作成します。以下を活用します。

• Web インターフェースには Chainlit
• データベースアクセスには Neo4j の MCP（Model Context Protocol）
• 自然言語の理解には Anthropic の Claude（LLM）

クイックスタートガイド

前提条件

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  # On Windows: .venv\Scripts\activate

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

uv pip install -r requirements.txt

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

cp .env.example .env

4. 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 のデモデータベース（Movie Graph）を使用します。

次のような質問を試してみてください。

• 「トム・ハンクスが出演した映画は何ですか？」
• 「俳優と監督の関係を見せてください」
• 「2010 年より後に公開された映画をすべて探してください」