Neo4j Mcpserver

🚀 Neo4j MCP サーバー

このサーバーは、モデルコンテキストプロトコルを通じてグラフデータベース操作を管理する Neo4j MCP サーバーの実装です。

🔌 Cursor とデスクトップ版 Claude と互換性があります！

🚀 クイックスタート

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

# 単一の接続文字列で実行
NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password npx neo4j-mcpserver

# または、個別の環境変数を使用
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 つの方法で提供できます。

1. 単一の接続文字列を使用する方法：

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

2. 個別の環境変数を使用する方法：

   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 サーバーを設定するには、以下の手順を実行します。

1. Cursor の設定を開きます。
2. 機能 > MCP サーバーをクリックします。
3. “+ 新しい MCP サーバーを追加” ボタンをクリックします。
4. 以下の情報を入力します。
   • 名前：サーバーのニックネームを入力します（例：“neo4j-mcp”）。
   • タイプ：タイプとして “コマンド” を選択します。
   • コマンド：サーバーを実行するコマンドを入力します。

     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

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

問題が発生した場合は、以下の手順を試してください。

1. Neo4j の資格情報を検証します。

   • Neo4j の URI、ユーザー名、パスワードが正しいことを確認します。
   • Neo4j データベースにアクセスできることを確認します。

2. パスの問題を確認します。

   • インストールパスに空白がないことを確認します。
   • パスでは正斜線 (/) を使用してください。

3. ツールの検出問題を解決します。

   • Cursor を再起動してみます。
   • サーバーが実行中であることを確認します（Cursor の MCP サーバーリストを確認）。
   • 環境変数が正しく設定されていることを確認します。

開発 👩💻

リポジトリからプロジェクトをクローンした後、以下の手順で開発を行います。

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

   git clone [リポジトリのURL]
   cd [プロジェクトディレクトリ]
   

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

   npm install
   

3. サーバーを起動します。

   npm start
   

4. テストを実行します。

   npm test
   

📄 ライセンス

MIT License

Copyright (c) [年] [作者名]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.