MCP Neo4j サーバー

Neo4j グラフデータベースと Claude Desktop の統合を提供し、自然言語による対話を通じてグラフデータベースの操作を可能にする MCP サーバーです。

クイックスタート

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

npx @alanse/mcp-neo4j

または、Claude Desktop 構成に追加します。

{
  "mcpServers": {
    "neo4j": {
      "command": "npx",
      "args": ["@alanse/mcp-neo4j-server"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "your-password"
      }
    }
  }
}

特徴

このサーバーは、Neo4j データベースと対話するためのツールを提供します。

ツール

execute_query : Neo4j データベースで Cypher クエリを実行する
- すべてのタイプの Cypher クエリ (READ、CREATE、UPDATE、DELETE) をサポートします
- クエリ結果を構造化された形式で返します
- インジェクション攻撃を防ぐためにパラメータを渡すことができる
create_node : グラフデータベースに新しいノードを作成する
- ノードラベルとプロパティを指定する
- 作成されたノードをその内部IDとともに返します
- プロパティのすべてのNeo4jデータ型をサポート
create_relationship : 既存の2つのノード間に関係を作成する
- 関係の種類と方向を定義する
- 関係にプロパティを追加する
- ソースノードとターゲットノードのノードIDが必要です

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の MCP Neo4j Server を自動的にインストールするには:

npx -y @smithery/cli install @alanse/mcp-neo4j-server --client claude

開発のために

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

git clone https://github.com/da-okazaki/mcp-neo4j-server.git
cd mcp-neo4j-server

依存関係をインストールします:

npm install

プロジェクトをビルドします。

npm run build

構成

サーバーには次の環境変数が必要です。

NEO4J_URI : Neo4j データベース URI (デフォルト: bolt://localhost:7687)
NEO4J_USERNAME : Neo4j ユーザー名 (デフォルト: neo4j)
NEO4J_PASSWORD : Neo4j パスワード (必須)

使用例

自然言語を使用して Neo4j データベースと対話する方法の例を次に示します。

データのクエリ

次のような質問をすることができます。

「営業部の従業員全員を表示」
「最も年長の顧客上位5人を見つける」
「先月3つ以上の商品を購入した人は誰ですか？」

例：

User: "Show me all employees in the Sales department"

Claude: Let me query the database for Sales department employees.

[Executes query internally: MATCH (e:Employee)-[:WORKS_IN]->(d:Department {name: 'Sales'}) RETURN e.name, e.position]

Result:
- John Smith (Sales Manager)
- Sarah Johnson (Sales Representative)
- Mike Brown (Account Executive)

データの作成

次のような指示を与えることができます:

「30歳のJohn Doeという新しい人物を追加します」
「価格24.99ドルの『プレミアムコーヒー』という商品を作成する」
「『研究開発』という新しい部門を追加する」

例：

User: "Add a new person named John Doe who is 30 years old"

Claude: I'll create a new Person node with the provided information.

[Creates node internally with label 'Person' and properties {name: 'John Doe', age: 30}]

Result: Created new person node with ID: 123

関係を築く

次のような関係をリクエストできます:

「ジョン・ドウをジェーン・スミスと友達にする」
「製品Aを製品Bのコンポーネントとして設定する」
「John Doeを営業部に割り当てる」

例：

User: "Make John Doe friends with Jane Smith"

Claude: I'll create a friendship relationship between these two people.

[Creates relationship internally: MATCH (a:Person {name: 'John Doe'}), (b:Person {name: 'Jane Smith'})
CREATE (a)-[:FRIENDS_WITH {since: '2024-01-05'}]->(b)]

Result: Created friendship relationship between John Doe and Jane Smith

複雑な操作

自然言語を使用すると、より複雑な操作を実行できます。

「ニューヨーク在住の顧客が購入したすべての商品を検索する」
「John Doeの友達の友達を表示」
「各部門の従業員の平均年齢を計算する」

例：

User: "Find all products purchased by customers who live in New York"

Claude: I'll query the database for this information.

[Executes query internally:
MATCH (c:Customer {city: 'New York'})-[:PURCHASED]->(p:Product)
RETURN c.name, collect(p.name) as products]

Result:
- Alice Wilson: [Premium Coffee, Tea Set, Cookies]
- Bob Miller: [Premium Coffee, Water Bottle]

テスト

テストスイートを実行します。

npm test

ライセンス

マサチューセッツ工科大学

MCP Neo4j Server

Integrations