Puppygraph MCP Server

🚀 Graph MCP 服務器

Graph MCP 服務器為 PuppyGraph 提供模型上下文協議 (MCP) 服務，允許 Claude 通過 Claude Desktop，使用 Gremlin 和 Cypher 查詢圖數據庫。

🚀 快速開始

在使用 Graph MCP 服務器之前，需要滿足以下先決條件：

1. 確保目標服務器正在運行並可通過網絡訪問
2. 驗證防火牆規則是否允許相應端口的通信
3. 確保提供的身份驗證憑據正確無誤

之後，按照以下步驟進行安裝：

# 安裝所有依賴項
npm install

# 啟動開發服務器
npm start

# 構建生產環境版本
npm run build

✨ 主要特性

• 使用 Neo4j Bolt 協議（用於 Cypher）和 WebSocket（用於 Gremlin）連接到多個 PuppyGraph 實例
• 使用 Gremlin 和 Cypher 查詢語言查詢圖數據
• 從多個端點獲取圖結構和模式信息
• 包含用於驗證連接狀態的工具

📦 安裝指南

# 安裝所有依賴項
npm install

# 啟動開發服務器
npm start

# 構建生產環境版本
npm run build

💻 使用示例

項目結構

puppy-graph-mcp/
├── src/                 # 源代碼目錄
│   ├── main.ts         # 主程序入口
│   └── services/       # 外部服務接口實現
├── tests/              # 測試用例
└── package.json        # 項目依賴和腳本

配置說明

• 環境變量 | 屬性 | 詳情 | |------|------| | 變量名 | 描述 | | PUPPYGRAPH_WS_URL | Gremlin WebSocket 地址，默認值為 ws://localhost:8080 | | PUPPYGRAPH_NEO4J_URI | Neo4j 連接 URI，默認值為 bolt://localhost:7687 | | PUPPYGRAPH_SCHEMA_URL | Schema HTTP 端點，默認值為 http://localhost:3000/schema |

工具使用

基礎用法

# 查詢連接狀態
puppygraph status

高級用法

# 執行 Cypher 查詢
puppygraph query --cypher "MATCH (n) RETURN count(n)"

# 執行 Gremlin 查詢
puppygraph gremlin g.V().count()

📚 詳細文檔

項目特點

• 模塊化架構：代碼按功能劃分模塊，便於維護和擴展
• 異步通信：使用 async/await 實現非阻塞操作
• 錯誤處理：提供詳細的錯誤日誌和重試機制
• 可擴展性：支持插件擴展以增加更多功能

項目狀態

當前版本為 v1.0.0，已通過基礎測試和驗證。

📄 許可證

本項目採用 Apache 2.0 許可證。