neo4j-server-remote

neo4j-server-remote

neo4j-server-remote は、Server-Sent Events（SSE）または STDIO をトランスポートプロトコルとして使用する MCP サーバーです。

概要

Neo4j を通じてデータベースとのやり取りやグラフの探索機能を提供する、Model Context Protocol（MCP）サーバーの実装です。このサーバーでは、Cypher によるグラフクエリの実行や複雑なドメインデータの分析が可能で、リモートからアクセスできるデータベースの選択にも対応しています。neo4j-contrib/mcp-neo4j に着想を得ています。

プロンプト

このサーバーは、デモ用プロンプトを提供します。

• mcp-demo：データベース操作をユーザーに案内する対話型プロンプト
  • 適切なデータベーススキーマとサンプルデータを生成します

ツール

このサーバーは、3 つの主要なツールを提供します。

クエリツール

• read-neo4j-cypher

  • データベースからデータを読み取るための Cypher 読み取りクエリを実行します
  • 入力：
    • query（文字列）：実行する Cypher クエリ
  • 戻り値：オブジェクトの配列としてのクエリ結果

• write-neo4j-cypher

  • 更新用の Cypher クエリを実行します
  • 入力：
    • query（文字列）：Cypher 更新クエリ
  • 戻り値：{ nodes_updated: number, relationships_created: number, ... } を含む結果の概要カウンター

スキーマツール

• get-neo4j-schema
  • グラフデータベース内のすべてのノードタイプと、名前および型を含む属性、他のノードタイプとのリレーションシップの一覧を取得します
  • 入力は不要です
  • 戻り値：ノードラベルのリストと、属性用およびリレーションシップ用の 2 つの辞書

Cline クライアントでの使用方法

1.リポジトリをクローンします

git clone https://github.com/dsimile/mcp-neo4j-server-sse.git

2.必要なものをインストールします

• Python 3.12+

cd mcp-neo4j-server-sse

pip install -r requirements.txt

3.サーバーを実行します

• SSE モード（デフォルト）

UX コマンドを使用して MCP サーバーを実行し、使用するデータベースを選択します。デフォルトの IP アドレスは 0.0.0.0、デフォルトのポートは 8543 です。

uv run .\src\mcp-neo4j-cypher\neo4j_server_remote.py --url bolt://localhost:7687 --username neo4j --password neo4j123 --database neo4j

• STDIO モード

モードを STDIO に設定し、同じ Neo4j 接続情報を指定して、UX コマンドで MCP サーバーをローカルで実行します。

注：Neo4j が実行中であり、リモート接続からアクセスできることを確認してください。

リリース済みパッケージ

サーバー設定を cline_mcp_settings.json に追加します。

• SSE モード（デフォルト）

{
  "mcpServers": {
    "neo4j-remote": {
      "url": "http://0.0.0.0:8543/sse",
      "disabled": false,
      "autoApprove": []
    }
  }
}

• STDIO モード

{
  "mcpServers": {
    "neo4j-local": {
      "disabled": false,
      "timeout": 60,
      "command": "uv",
      "args": [
        "run",
        "/absolute/path/to/neo4j_server_remote.py",
        "--url",
        "bolt://localhost:7687",
        "--username",
        "neo4j",
        "--password",
        "neo4j123",
        "--database",
        "neo4j",
        "--mode",
        "stdio"
      ]
    }
  }
}

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。つまり、MIT ライセンスの利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。