Memos MCP 服务器

通过 MCP（模型上下文协议）服务器与 Memos 实例进行交互，支持通过 AI 助手如 Claude 进行互动。

特性

• 🔄 连接到用户的 Memos 实例：通过 API 密钥建立安全连接
• 📚 作为资源暴露 API：提供对 memos 的结构化访问
• 🔍 提供强大的工具：搜索、创建、更新、删除 memos 和其他功能
• 🏷️ 标签管理：自动为新 memos 添加标签
• 🔎 高级搜索：支持使用 CEL 表达式进行复杂过滤
• 📝 提示模板：包含改进日常操作的建议

安装和配置

可以在配置文件中包含此包，如下所示，就像使用其他 Python MCP 插件一样。

{
  "mcpServers": {
    "memos-mcp": {
      "command": "uvx",
      "args": [
        "memos-mcp"
      ],
      "env": {
        "MEMOS_URL": "https://your-memos-instance-url",
        "MEMOS_API_KEY": "your-memos-api-key"
      }
    }
  }
}

先决条件

• Python 3.8 或更高版本
• 可访问的 Memos 实例
• Memos API 密钥

安装步骤

1. 克隆此仓库：

   git clone https://github.com/yourusername/memos-mcp.git
   cd memos-mcp
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 配置环境变量：

   • 复制 .env.example 为 .env
   • 编辑 .env 文件，填写以下信息：

     MEMOS_URL=https://your-memos-instance-url
     MEMOS_API_KEY=your-memos-api-key
     DEFAULT_TAG=mcp  # 可选，默认标签
     

使用说明

启动服务器

python memos_mcp_server.py

连接到 Claude Desktop

1. 安装 Claude Desktop
2. 在 Claude Desktop 中添加 MCP 服务器
3. 使用 Claude 与您的 Memos 进行互动

使用 MCP 开发工具测试

mcp dev memos_mcp_server.py

可用资源

• memos://recent - 获取最新 memo
• memos://all - 获取所有 memos
• memos://memos/{memo_id} - 根据指定 ID 检索 memo

可用工具

搜索和过滤

• search_memos(query, filter_expr) - 搜索 memo
• filter_memos(filter_expr) - 使用 CEL 表达式过滤 memos

创建和管理

• create_memo(content, visibility, tags) - 创建新的 memo
• update_memo(memo_id, content, visibility) - 更新 memo
• delete_memo(memo_id) - 删除 memo
• delete_memo_tag(memo_id, tag) - 从 memo 中移除标签

提示模板

• daily-review - 日常 memo 回顾
• weekly-summary - 周度 memo 概要
• knowledge-extraction - 从 memo 中提取知识
• content-improvement - 改进 memo 内容

示例 CEL 表达式

可以使用 CEL（通用表达式语言）表达式进行高级过滤：

• 按内容过滤：content.contains('关键词')
• 按创建时间过滤：createTime > timestamp('2023-01-01T00:00:00Z')
• 按可见性过滤：visibility == 'PRIVATE'
• 组合条件：content.contains('关键词') && visibility == 'PRIVATE'

示例用法

搜索 memo

search_memos(query="项目")

使用 CEL 表达式过滤

filter_memos(filter_expr="createTime > timestamp('2023-01-01T00:00:00Z') && visibility == 'PRIVATE'")

创建带有标签的 memo

create_memo(content="完成 MCP 服务器项目", tags=["项目", "编程"])

贡献

欢迎提交问题和拉取请求！

许可证

MIT