Memos MCP Enhanced

Memos MCP服务器增强

](https://pypi.org/project/memos-mcp-enhanced/)  ](https://github.com/Mebigger/memos-mcp-enhanced/releases)

英语 | 中文

🇬🇧 英语

增强 模型上下文协议（MCP） 服务器 备忘录，使LLM（如Claude、Cursor等）能够与您的Memos知识库无缝交互。

隐私声明：此项目在您的计算机上本地运行。您的Memos数据仅由您授权的MCP客户端访问。

✨ 主要特点

• 完成CRUD：创建、阅读、更新和删除备忘录。
• 智能搜索：支持自然语言日期过滤（例如，“查找上周的笔记”，“搜索2024年的会议”）。 现在支持搜索存档的备忘录！
• 任务管理：用于管理TODO列表的专用工具(list_todos, create_todo, complete_todo).
• 资源管理：上传文件、管理附件并将其附加到备忘录中。
• 批量操作：一次性存档或删除多个备忘录。
• 模板系统：使用变量替换从可重用模板创建备忘录。
• 导出工具：将内容导出到黑曜石保管库或微信公众号格式。

🚀 快速开始

先决条件

• 跑步 备忘录 实例（建议使用v0.2+）。
• 内存中的API令牌（设置->访问令牌）。
• uv 已安装（推荐）或Python 3.10+。

配置（克劳德桌面/光标）

将以下内容添加到MCP配置文件中：

{
  "memos": {
    "command": "uvx",
    "args": ["memos-mcp-enhanced"],
    "env": {
      "MEMOS_INSTANCE_URL": "https://your-memos-url.com",
      "MEMOS_API_TOKEN": "your-api-token-here"
    }
  }
}

📦 安装（本地开发）

1. 克隆存储库：

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

1. 创建一个 .env 文件：

   cp .env.example .env
   # Edit .env with your configuration

1. 运行服务器：

   uv run memos-mcp

🛠️ 可用工具

服务器公开了26个工具，包括：

• search_memos：使用关键字和日期范围进行搜索。
• create_memo / update_memo：管理备忘录内容和元数据（包括回溯）。
• upload_resource / add_attachment：处理文件。
• batch_operation：批量操作。
• export_to_obsidian：同步到本地保管库。

______________________________________________________________________

🇨🇳 中文

备忘录 的增强版 模型上下文协议（MCP） 服务器。它赋予了 LLM（如 Claude, Cursor 等）读写和管理你 Memos 知识库的能力。

隐私说明：此服务在您的本地机器上运行。您的 Memos 数据仅在您授权的 MCP 客户端中处理，不会上传到任何第三方服务器。

✨ 核心功能

• 全功能 CRUD: 创建、读取、更新、删除笔记。
• 智能搜索: 支持自然语言的日期过滤搜索（支持如 "查找上周的笔记"、"搜索去年的记录" 等自然语言）。现已支持搜索归档笔记！
• 待办管理: 专门的 TODO 管理工具 (list_todos, create_todo, complete_todo)。
• 附件管理: 支持文件上传、管理及绑定到笔记。
• 批量操作: 支持批量归档、删除笔记。
• 模板系统: 内置模板引擎，支持参数替换，快速生成周报、日记等。
• 导出工具: 支持将笔记导出到 Obsidian 本地库，或格式化为微信公众号文章。

� 快速开始

前置要求

• 一个运行中的 备忘录 实例 (建议 v0.22+)。
• Memos API Token (在 设置 -> Access Tokens 中获取)。
• 安装 uv (推荐) 或 Python 3.10+。

配置方式 (Claude Desktop / Cursor)

在您的 MCP 配置文件中添加以下内容：

{
  "memos": {
    "command": "uvx",
    "args": ["memos-mcp-enhanced"],
    "env": {
      "MEMOS_INSTANCE_URL": "https://your-memos-url.com",
      "MEMOS_API_TOKEN": "your-api-token-here"
    }
  }
}

📦 本地开发安装

1. 克隆仓库：

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

1. 配置环境变量：

   cp .env.example .env
   # 编辑 .env 文件填入你的 API 信息

1. 运行服务：

   uv run memos-mcp

🛠️ 可用工具

本服务提供 26 个增强工具，包括但不限于：

• search_memos: 支持关键词和自然语言日期范围搜索。
• create_memo / update_memo: 管理笔记内容、属性（支持修改显示时间）。
• upload_resource / add_attachment: 文件上传与附件管理。
• batch_operation: 批量处理。
• export_to_obsidian: 导出到本地 Obsidian 库。

______________________________________________________________________

许可证

麻省理工学院