MCP Neo4j Memory Server

🚀 MCP Neo4j 知識圖譜內存服務器

MCP Neo4j 知識圖譜內存服務器為知識圖譜的存儲和查詢提供了高效的解決方案。它基於 Neo4j 數據庫，支持靈活的配置和多樣化的查詢方式，能滿足不同場景下對知識圖譜的使用需求。

🚀 快速開始

你可以通過 NPM 安裝或者手動下載源代碼的方式來安裝 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