MCP Memory Server

🚀 MCP內存服務器

本項目是一個模型上下文協議（Model Context Protocol，MCP）服務器的實現，為大語言模型提供持久化內存功能，助力模型在不同對話和會話中更好地存儲、檢索和推理信息。

🚀 快速開始

本倉庫包含 模型上下文協議 內存服務器的參考實現。該服務器基於知識圖譜構建了持久化內存系統，使大語言模型能夠在不同對話和會話中存儲、檢索信息並進行推理。

✨ 主要特性

• 知識圖譜存儲：基於圖結構實現信息的持久化存儲。
• 實體管理：創建和管理實體及其關係。
• 語義搜索：利用語義相似度查找相關信息。
• 跨會話記憶：在不同對話間保持上下文連貫性。
• 內存操作：支持完整的CRUD操作，方便進行內存管理。

📦 安裝指南

npm install
npm run build

💻 使用示例

基礎用法

運行內存服務器：

npx mcp-server-memory

開發模式

npm run watch

此命令會以開發模式啟動服務器，當文件發生更改時會自動重新構建。

直接執行

在開發和測試階段，可直接運行服務器：

# 若尚未構建，先進行構建
npm run build

# 運行服務器
node dist/index.js

使用npm二進制文件

構建完成後，可使用npm二進制文件名來運行服務器：

npx mcp-server-memory

作為後臺進程

服務器會持續運行，並通過標準輸入輸出（stdio）進行通信，這也是MCP服務器的標準通信方式。

📚 詳細文檔

使用MCP檢查器進行測試

MCP檢查器 是開發過程中測試和調試內存服務器的優秀工具：

啟動檢查器

npx @modelcontextprotocol/inspector node dist/index.js

執行此命令會：

1. 啟動代理服務器（通常在 127.0.0.1:6277）。
2. 啟動基於Web的檢查器界面（通常在 http://127.0.0.1:6274）。
3. 提供用於身份驗證的會話令牌。

使用檢查器

檢查器提供了多個選項卡用於測試服務器：

• 資源選項卡：查看和測試內存資源。
• 工具選項卡：測試內存管理工具（創建、更新、刪除實體）。
• 提示選項卡：測試任何提示模板。
• 通知面板：監控服務器日誌和消息。

開發工作流程

1. 對 src/index.ts 進行修改。
2. 運行 npm run build 進行重新構建。
3. 啟動檢查器：npx @modelcontextprotocol/inspector node dist/index.js。
4. 在Web界面中測試更改。
5. 檢查通知面板是否有錯誤信息。

與MCP客戶端集成

要將此服務器與MCP客戶端（如Claude Desktop）配合使用，需將其添加到客戶端配置中：

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/your/mcp-memory-server/dist/index.js"]
    }
  }
}

若已發佈到npm，可使用以下配置：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-memory"]
    }
  }
}

模型上下文協議

模型上下文協議（MCP）是一個開放標準，旨在實現AI應用程序與外部數據源和工具的無縫集成。欲瞭解更多信息，請訪問 modelcontextprotocol.io。

📄 許可證

本項目採用MIT許可證。