MCP Neo4j Memory Server

🚀 MCP Neo4j 知識グラフメモリサーバ

Neo4jをベースにした知識グラフメモリサーバで、データの管理とクエリを効率的に行います。

🚀 クイックスタート

MCP Neo4j知識グラフメモリサーバを使用することで、知識グラフの管理とクエリを効率的に行うことができます。以下に、サーバのインストール、設定、使用方法を説明します。

📦 インストール

NPM経由でのインストール

npm install mcp-neo4j

手動インストール

1. ソースコードをダウンロードします：

   git clone https://github.com/your-repository.git
   cd mcp-neo4j
   

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

   npm install
   

🛠️ 設定

環境変数の設定

サーバの動作を設定するには、以下の環境変数を設定します：

設定例

export MCP_PORT=3001
export MCP_DB_URI=http://localhost:7687

💻 使用例

基本的な使用法

JavaScriptで使用する場合：

const { MemoryKnowledgeGraph } = require('mcp-neo4j');
const graph = new MemoryKnowledgeGraph({
  port: 3000,
  dbUri: 'http://localhost:7474',
  dbUser: 'neo4j',
  dbPassword: 'password'
});

// 知識グラフをクエリする
async function queryKnowledgeGraph() {
  const results = await graph.search('ユーザー情報を検索');
  console.log(results);
}

queryKnowledgeGraph();

高度な使用法

曖昧検索

const results = await graph.fuzzySearch('部分一致する内容');

🗄️ プロジェクト固有の知識グラフデータベースの切り替え

データベース管理コマンド

📄 データベース管理API

現在のデータベースを取得する

graphGetCurrentDatabase(): Promise<string>;

データベースを切り替える

graphSwitchDatabase(newDbName: string, createIfNotExists: boolean): Promise<void>;

すべてのデータベースをリストする

graphListDatabases(): Promise<string[]>;

🔧 技術詳細

グラフデータベースの構造

知識グラフはNeo4jに保存されており、以下はそのアーキテクチャ図です：

graph TD
    E[エンティティ] -->|HAS_OBSERVATION| O[観測値]
    E1[エンティティ] -->|RELATES_TO| E2[エンティティ]
    P[プロジェクト] -->|CONTAINS| F[ファイル]
    F -->|HAS_FUNCTION| Fn[関数]
    F -->|HAS_CLASS| C[クラス]
    P -->|HAS_ERROR| Er[エラー]
    P -->|HAS_REQUIREMENT| R[要件]

    classDef entity fill:#f9f,stroke:#333,stroke-width:2px;
    classDef observation fill:#bbf,stroke:#333,stroke-width:1px;
    classDef project fill:#fdf,stroke:#333,stroke-width:3px;
    classDef file fill:#fff,stroke:#333,stroke-width:1px;
    classDef function fill:#ffw,stroke:#333,stroke-width:1px;
    classDef error fill:#fww,stroke:#333,stroke-width:1px;
    classDef requirement fill:#www,stroke:#333,stroke-width:1px;

    E, E1, E2 -> entity
    O -> observation
    P -> project
    F -> file
    Fn -> function
    Er -> error
    R -> requirement

実装の利点

• 高速なクエリ：Cypherクエリ言語を使用して、迅速なデータ検索を実現します。
• 拡張性：カスタムプラグインをサポートし、機能を拡張できます。
• セキュリティ：認証とアクセス制御メカニズムを統合しています。

🛠️ 開発

依存関係のインストール

pnpm install

テストの実行

npm test

プロジェクトのビルド

npm run build

📄 ライセンス

MIT License