Memory MCP Server Go

🚀 內存 MCP 服務器 Go 實現

本項目是內存 MCP 服務器的 Go 語言實現，可用於 AI 助手長期記憶、知識管理等場景，能幫助組織信息、追蹤關係和保留上下文。

🚀 快速開始

你可以按照以下步驟快速安裝和使用本項目。

📦 安裝指南

快速安裝

使用以下命令快速安裝最新版本：

go install github.com/mark3labs/memory-mcp-server-go@latest

手動構建

若你想手動構建項目，可按以下步驟操作：

1. 克隆倉庫：

git clone https://github.com/mark3labs/memory-mcp-server-go.git
cd memory-mcp-server-go

2. 安裝依賴項：

go mod tidy

3. 構建二進制文件：

go build -o bin/memory-mcp-server-go .

💻 使用示例

啟動服務器

使用以下命令啟動服務器，並指定端口：

memory-mcp-server-go --port 5001

配置

默認配置

• 監聽地址：localhost
• 端口：5001
• 數據文件路徑：當前目錄下的 memory.json

示例命令

基礎用法

創建實體：

memory-mcp-server-go --port 5001 create_entities '{"name":"John Smith","entityType":"Person","observations":["Software engineer","Lives in San Francisco","Enjoys hiking"]}'

高級用法

建立關係：

memory-mcp-server-go --port 5001 create_relations '{"from":"John Smith","to":"Acme Corp","relationType":"works at"}'

📚 詳細文檔

知識圖譜結構

實體

知識圖譜中的實體結構示例如下：

{
  "entities": [
    {
      "name": "John Smith",
      "entityType": "Person",
      "observations": ["Software engineer", "Lives in San Francisco", "Enjoys hiking"]
    }
  ]
}

關係

知識圖譜中的關係結構示例如下：

{
  "relations": [
    {
      "from": "John Smith",
      "to": "Acme Corp",
      "relationType": "works at"
    }
  ]
}

使用場景

• AI 助手的長期記憶：使 AI 助手能夠記住用戶的偏好、過去的互動和重要事實。
• 知識管理：組織關於人、地點、事件和概念的信息。
• 關係追蹤：維護實體之間的關係網絡。
• 上下文持久性：保留重要的上下文跨多個會話。

配置示例

配置用於 Claude.app

在你的 Claude 設置中添加以下內容：

"mcpServers": {
  "memory": {
    "command": "memory-mcp-server-go",
    "env": {
      "MEMORY_FILE_PATH": "/Path/Of/Your/memory.json"
    }
  }
}

配置用於 Cursor

在你的 Cursor 設置的 mcp.json 中添加以下內容：

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp-server-go",
      "env": {
        "MEMORY_FILE_PATH": "/Path/Of/Your/memory.json"
      }
    }
  }
}

系統提示示例

你可以使用以下系統提示來幫助 Claude 更好地利用 memory-mcp-server：

你有一個知識圖譜記憶系統，可以存儲和檢索對話中的信息。請使用這個系統來記住重要的上下文和關聯。

內存文件路徑

• 默認路徑：./memory.json
• 可通過環境變量 MEMORY_FILE_PATH 自定義。

錯誤處理

常見錯誤

1. 文件不存在：
   • 檢查文件路徑是否正確。
   • 初始化一個新文件：touch memory.json
2. 端口被佔用：
   • 捕獲錯誤信息：地址已被使用
   • 嘗試其他端口：--port 5002

升級

使用以下命令升級到最新版本：

go install github.com/mark3labs/memory-mcp-server-go@latest

貢獻

• 提交問題到 GitHub Issues。
• 提交功能請求或修復。

📄 許可證

本項目採用 MIT 許可證。

🔧 技術細節

依賴項

• Go 標準庫
• 其他自定義包