Memos MCP 服务器

Memos MCP 服务器

site icon
2025.04.05 0
Python笔记管理AI 集成交流协作
Memos MCP 服务器是一个连接到 Memos 的 MCP (Model Context Protocol) 服务器,允许用户通过 AI 助手(如 Claude)与 Memos 实例进行交互。它提供了对备忘录的结构化访问,支持搜索、创建、更新、删除备忘录等功能,并包含标签管理和高级搜索能力。
View on GitHub

Overview

基本能力

产品定位

Memos MCP 服务器是一个中间件服务,旨在连接 Memos 笔记应用与 AI 助手,提供结构化的 API 访问和自动化操作能力。

核心功能

  • 连接到用户的 Memos 实例
  • 将 API 暴露为资源
  • 提供强大的工具(搜索、创建、更新、删除备忘录)
  • 标签管理
  • 高级搜索(支持 CEL 表达式)
  • 提示模板(用于日常操作改进)

适用场景

  • 通过 AI 助手管理 Memos 笔记
  • 自动化备忘录处理流程
  • 高级搜索和过滤备忘录
  • 批量操作备忘录

工具列表

  1. 搜索和过滤工具
  2. search_memos(query, filter_expr) - 搜索备忘录
  3. filter_memos(filter_expr) - 使用 CEL 表达式过滤备忘录

  4. 创建和管理工具

  5. create_memo(content, visibility, tags) - 创建新备忘录
  6. update_memo(memo_id, content, visibility) - 更新备忘录
  7. delete_memo(memo_id) - 删除备忘录
  8. delete_memo_tag(memo_id, tag) - 从备忘录中删除标签

  9. 提示模板

  10. daily-review - 每日备忘录回顾
  11. weekly-summary - 每周备忘录总结
  12. knowledge-extraction - 从备忘录中提取知识
  13. content-improvement - 改进备忘录内容

常见问题解答

  1. 如何获取 Memos API 密钥? 需要在 Memos 实例中生成 API 密钥

  2. CEL 表达式支持哪些操作? 支持内容过滤、时间过滤、可见性过滤等操作

使用教程

使用依赖

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

安装教程

  1. 克隆此仓库: bash git clone https://github.com/yourusername/memos-mcp.git cd memos-mcp

  2. 安装依赖: bash pip install -r requirements.txt

  3. 配置环境变量:

  4. 复制 .env.example.env
  5. 编辑 .env 文件,填写以下信息: MEMOS_URL=https://your-memos-instance-url MEMOS_API_KEY=your-memos-api-key DEFAULT_TAG=mcp # 可选,默认标签

调试方式

  1. 启动服务器: bash python memos_mcp_server.py

  2. 使用 MCP 开发工具测试: bash mcp dev memos_mcp_server.py

  3. 连接到 Claude Desktop 进行交互测试

许可证

该项目遵循 MIT 开源许可条款。