AI导哈

备忘录协议服务器

一个基于Memos实例的模型上下文协议服务器，提供搜索、创建和更新备忘录的功能。

  • by Red5d
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 Red5d/memos_mcp

使用说明

Memos MCP 服务器

一个MCP（模型上下文协议）服务器，提供与（某系统或模型）交互的工具 备忘录 例子 这台服务器允许AI助手通过备忘录API搜索、创建和更新备忘录。

特点

  • 搜索备忘录使用创建者、标签、可见性等过滤器搜索备忘录
  • 创建备忘录创建支持Markdown的新备忘录
  • 更新备忘录更新现有备忘录（内容、可见性、固定状态）
  • 获取备忘录通过UID检索特定备忘录

安装

  1. 克隆此仓库：
git clone <repository-url>
cd memos_mcp
  1. 安装依赖项：

使用紫外线（推荐）

uv sync

使用 pip

pip install -r requirements.txt

配置

设置以下环境变量：

  • MEMOS_BASE_URL您Memos实例的基础URL（默认： http://localhost:5230)
  • MEMOS_API_TOKEN您的备忘录API认证令牌（对于公开实例为可选）

获取API令牌

  1. 登录到您的Memos实例
  2. 进入设置 → 访问令牌
  3. 创建一个新的访问令牌
  4. 复制令牌并将其设置为 MEMOS_API_TOKEN 环境变量

示例：

export MEMOS_BASE_URL="https://memos.example.com"
export MEMOS_API_TOKEN="your-token-here"

用法

运行服务器

使用uvx（无需安装）

# Run directly with uvx
uvx --from . memos-mcp

安装后使用紫外线灯

# After running 'uv sync'
uv run memos-mcp

直接使用FastMCP

fastmcp run server.py

程序化使用

from server import mcp

# The server is ready to use

可用工具

1. 搜索备忘录

使用可选过滤器搜索备忘录。

参数：

  • query （可选）：在备忘录内容中搜索的文本
  • creator_id （可选）：按创建者用户ID过滤
  • tag （可选）：按标签名称过滤
  • visibility （可选）：按可见性过滤（公共、受保护、私有）
  • limit （默认：10）：最大结果数量
  • offset （默认值：0）：要跳过的结果数量

示例：

result = await search_memos(query="meeting notes", limit=5)

2. 创建备忘录

创建一个新的备忘录。

参数：

  • content备忘录的内容（支持Markdown）
  • visibility （默认：PRIVATE）：可见性级别（PUBLIC，PROTECTED，PRIVATE）

示例：

result = await create_memo(
    content="# Meeting Notes\n\n- Discuss project timeline\n- Review budget",
    visibility="PRIVATE"
)

3. 更新备忘录

更新现有备忘录。

参数：

  • memo_uid要更新的备忘录的UID
  • content （可选）：备忘录的新内容
  • visibility （可选）：新的可见性级别
  • pinned （可选）：是否固定备忘录

示例：

result = await update_memo(
    memo_uid="abc123",
    content="Updated content",
    pinned=True
)

4. 获取备忘录

通过UID获取特定的备忘录。

参数：

  • memo_uid要检索的备忘录的UID

示例：

result = await get_memo(memo_uid="abc123")

与MCP客户端的集成

Claude Desktop（可译为“Claude桌面版”或保持原样，根据上下文判断是否需要具体翻译）

在您的Claude桌面配置文件中添加：

macOS（发音为“Mac OS”，全称为“macintosh Operating System”，即苹果电脑操作系统）： ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

使用uvx（推荐 - 无需安装）

{
  "mcpServers": {
    "memos": {
      "command": "uvx",
      "args": ["--from", "/path/to/memos_mcp", "memos-mcp"],
      "env": {
        "MEMOS_BASE_URL": "http://localhost:5230",
        "MEMOS_API_TOKEN": "your-token-here"
      }
    }
  }
}

使用紫外线灯（安装后）

{
  "mcpServers": {
    "memos": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/memos_mcp", "memos-mcp"],
      "env": {
        "MEMOS_BASE_URL": "http://localhost:5230",
        "MEMOS_API_TOKEN": "your-token-here"
      }
    }
  }
}

直接使用Python

{
  "mcpServers": {
    "memos": {
      "command": "python",
      "args": ["-m", "fastmcp", "run", "/path/to/memos_mcp/server.py"],
      "env": {
        "MEMOS_BASE_URL": "http://localhost:5230",
        "MEMOS_API_TOKEN": "your-token-here"
      }
    }
  }
}

API 参考文档

这个服务器是基于Memos API v1构建的。该API遵循谷歌的API改进提案（AIPs）设计指南。

API 端点使用情况

  • GET /api/v1/memos - 列出/搜索备忘录
  • POST /api/v1/memos - 创建一个备忘录
  • GET /api/v1/memos/{uid} - 获取特定的备忘录
  • PATCH /api/v1/memos/{uid} - 更新备忘录

认证

服务器支持Bearer令牌认证。请在请求中包含您的访问令牌 Authorization 头球

Authorization: Bearer your-token-here

发展

运行测试

pytest

代码结构

  • server.py主要MCP服务器实现及其所有工具
  • requirements.txtPython 依赖项

关于备忘录

Memos 是一个轻量级的自托管备忘录中心，具备知识管理和社交网络功能。了解更多信息，请访问：

  • 网站：https://www.usememos.com/
  • GitHub链接：https://github.com/usememos/memos

许可证

MIT 许可证 - 详情请参见 LICENSE 文件

贡献

欢迎贡献！请随时提交拉取请求。

相关 MCP