Memphora MCP

🚀 Memphora MCP 服務器

Memphora MCP 服務器藉助模型上下文協議（MCP），為 Claude、Cursor、Windsurf 等 AI 助手添加持久內存功能，讓 AI 能夠跨對話記憶信息、搜索個人知識庫、自動提取對話見解以及回憶用戶的偏好、事實和上下文。

🚀 快速開始

📦 安裝

可以使用以下兩種方式進行安裝：

# 使用 pip
pip install memphora-mcp

# 或者使用 uvx（推薦用於 Claude 桌面版）
uvx memphora-mcp

🔑 獲取 API 密鑰

1. 訪問 memphora.ai/dashboard。
2. 創建賬戶或登錄。
3. 從儀表盤複製你的 API 密鑰。

⚙️ 配置 Claude 桌面版

將以下內容添加到 Claude 桌面版的配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memphora": {
      "command": "uvx",
      "args": ["memphora-mcp"],
      "env": {
        "MEMPHORA_API_KEY": "your_api_key_here",
        "MEMPHORA_USER_ID": "your_unique_user_id"
      }
    }
  }
}

🔄 重啟 Claude 桌面版

關閉並重新打開 Claude 桌面版，你應該能看到 Memphora 工具可用！

💻 使用示例

📥 存儲記憶

只需告訴 Claude 關於你自己的一些事情：

你: "我在谷歌擔任軟件工程師"
Claude: [存儲記憶] "明白了！我會記住你在谷歌擔任軟件工程師。"

你: "我最喜歡的編程語言是 Python"
Claude: [存儲記憶] "記下了！我會記住你最喜歡的編程語言是 Python。"

📤 回憶記憶

詢問 Claude 你之前告訴過它的事情：

你: "我在哪裡工作？"
Claude: [搜索記憶] "你在谷歌擔任軟件工程師。"

你: "我喜歡什麼編程語言？"
Claude: [搜索記憶] "你最喜歡的編程語言是 Python。"

📚 自動上下文

Claude 會在相關時自動搜索你的記憶：

你: "你能幫我處理一些代碼嗎？"
Claude: [搜索記憶以獲取上下文]
        "當然！由於你更喜歡 Python 並且在谷歌工作，我將按照谷歌的風格指南用 Python 編寫這段代碼..."

🛠️ 可用工具

⚙️ 配置選項

🤝 與其他 MCP 客戶端配合使用

Cursor

將以下內容添加到你的 Cursor 設置中：

{
  "mcp": {
    "servers": {
      "memphora": {
        "command": "uvx",
        "args": ["memphora-mcp"],
        "env": {
          "MEMPHORA_API_KEY": "your_api_key_here"
        }
      }
    }
  }
}

Windsurf

將以下內容添加到你的 Windsurf MCP 配置中：

{
  "mcpServers": {
    "memphora": {
      "command": "python",
      "args": ["-m", "memphora_mcp"],
      "env": {
        "MEMPHORA_API_KEY": "your_api_key_here"
      }
    }
  }
}

🛠️ 開發

🏠 本地運行

# 克隆倉庫
git clone https://github.com/Memphora/memphora-mcp.git
cd memphora-mcp

# 安裝依賴
pip install -e ".[dev]"

# 設置你的 API 密鑰
export MEMPHORA_API_KEY="your_key"

# 運行服務器
python -m memphora_mcp

🧪 測試

pytest tests/

🔒 隱私與安全

• 你的記憶安全地存儲在 Memphora 的雲端。
• 每個用戶都有獨立的記憶存儲空間。
• API 密鑰存儲在你的本地機器上。
• 所有通信都通過 HTTPS 加密。

📞 支持

• 文檔：memphora.ai/docs
• 問題反饋：GitHub Issues
• 郵箱：support@memphora.ai

📄 許可證

本項目採用 MIT 許可證，詳情請見 LICENSE。