Neo4j MCP Server

Name: Neo4j MCP Server
Author: Tobarrientos2

ローカル

github.com/Tobarrientos2データベース489 週間前に更新

リポジトリ

Neo4j MCP Server について

Neo4j MCP ServerはMCPクライアントをNeo4jグラフデータベースに接続し、Cypherクエリを実行できるようにします。接続情報で設定し、CursorとClaude Desktopに対応しています。

主な機能

01Neo4jへのCypherクエリ実行
02環境変数による接続設定
03.envファイルからの設定読み込み
04CursorとClaude Desktopへの対応

活用シーン

01MCPクライアントからグラフデータを検索
02Cypherによるノードの確認

MCP 対応

MCPクライアントに、Neo4jデータベースでCypherクエリを実行する`neo4j-query`ツールを提供します。

#neo4j #graph-database #mcp-server

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "neo4j-mcpserver": {
      "command": "npx",
      "args": [
        "-y",
        "neo4j-mcpserver"
      ],
      "env": {
        "NEO4J_CONNECTION": "<NEO4J_CONNECTION>"
      }
    }
  }
}

起動コマンドnpx -y neo4j-mcpserver

設定が必要な環境変数

NEO4J_CONNECTION

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmneo4j-mcpserverstdio

ツール

掲載時のツール一覧 · 3 週間前に更新

パラメーター	型	必須
pulse	object	はい
pulse.name	string	はい
pulse.version	string	いいえ
pulse.description	string	いいえ
pulse.isAsync	boolean	いいえ
pulse.isMainPulse	boolean	いいえ
pulse.fileLocation	string	はい
entity	string	はい
action	string	はい
dataStructures	object	いいえ
dataStructures.inputs	array	いいえ
dataStructures.outputs	array	いいえ
relationships	array	いいえ

詳細

Neo4j MCP サーバー

Model Context Protocol を通じてグラフデータベースの操作を管理する Neo4j MCP サーバーの実装です。

🔌 Cursor と Claude Desktop の両方に対応しています！

クイックスタート

npx を使ってサーバーを直接実行できます。

# Using a single connection string
NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password npx neo4j-mcpserver

# Or using separate environment variables
NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io NEO4J_USER=neo4j NEO4J_PASSWORD=your-password npx neo4j-mcpserver

インストール

パッケージをグローバルにインストールする場合：

npm install -g neo4j-mcpserver

次に、実行します。

NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password neo4j-mcpserver

環境変数

Neo4j の接続情報は、次の 2 つの方法で指定できます。

単一の接続文字列を使用する：

NEO4J_CONNECTION=<uri>,<user>,<password>

個別の環境変数を使用する：

NEO4J_URI=<your-uri>
NEO4J_USER=<your-user>
NEO4J_PASSWORD=<your-password>

プロジェクトのルートにある .env ファイルも使用できます。

NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password

設定 ⚙️

Cursor の設定 🖥️

Cursor で Neo4j MCP サーバーを設定するには：

Cursor の設定を開きます
「機能」>「MCP サーバー」に移動します
「+ 新しい MCP サーバーを追加」ボタンをクリックします
次の情報を入力します：
- 名前：サーバーのニックネームを入力します（例：「neo4j-mcp」）
- 種類：種類として「command」を選択します
- コマンド：サーバーを実行するコマンドを入力します：
```
env=NEO4J_URI=your-neo4j-uri,NEO4J_USER=your-neo4j-user,NEO4J_PASSWORD=your-neo4j-password npx -y @neobarrientos/neo4j_mcpserver
```
重要：認証情報を実際の Neo4j データベースの認証情報に置き換えてください。

利用可能なツール 🛠️

neo4j-query

Neo4j データベースに対して Cypher クエリを実行します。

Cursor での使用例：

MATCH (n) RETURN n LIMIT 5

トラブルシューティング 🔧

問題が発生した場合：

Neo4j の認証情報を確認する
- Neo4j の URI、ユーザー名、パスワードが正しいことを確認します
- Neo4j データベースにアクセスできることを確認します
パスの問題
- インストールパスにスペースが含まれていないことを確認します
- パスにはスラッシュ（/）を使用します
ツールの検出に関する問題
- Cursor を再起動してみます
- サーバーが実行中であることを確認します（Cursor の MCP サーバー一覧を確認してください）
- 環境変数が正しく設定されていることを確認します

開発 👩‍💻

ローカルで実行するには：

git clone <repository-url>
cd neo4j-mcpserver
npm install
npm run build
npm start

ライセンス

ISC

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。