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。