MCP Server Memos 📝

一个 Python 包，提供 LLM 模型通过 MCP (Model Context Protocol) 接口与 Memos 服务器交互的能力。

🚀 功能

• 🔍 使用关键词搜索备忘录
• ✨ 创建具有自定义可见性的新备忘录
• 📖 根据 ID 获取备忘录内容
• 🏷️ 列出并管理备忘录标签
• 🔐 使用访问令牌进行安全认证

🛠️ 使用方法

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

{
  ...,
  "mcpServers": {
    "fetch": { // 其他 mcp 服务器
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "memos": { // 添加到您的配置
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "mcp-server-memos",
        "--host",
        "localhost",
        "--port",
        "5230",
        "--token",
        "your-access-token-here"
      ]
    }
  }
}

<details> <summary>使用此包的其他方式</summary>

📦 安装

通过 Smithery 安装

要通过 Smithery 自动安装 mcp-server-memos-py 到 Claude Desktop：

npx -y @smithery/cli install @RyoJerryYu/mcp-server-memos-py --client claude

手动安装

pip install mcp-server-memos

命令行

mcp-server-memos --host localhost --port 8080 --token YOUR_ACCESS_TOKEN

作为库

from mcp_server_memos import Config, serve_stdio

config = Config(
    host="localhost",
    port=8080,
    token="YOUR_ACCESS_TOKEN"
)

await serve_stdio(config=config)

</details>

🔧 配置

参数	描述	默认值
host	Memos 服务器主机名	localhost
port	Memos 服务器端口	8080
token	认证用的访问令牌	""

🤝 提供的工具

此 MCP 服务器提供了以下工具来与 Memos 进行交互：

工具名称	描述	参数
list_memo_tags	列出所有现有的备忘录标签	- parent: 拥有这些标签的父项（格式：memos/{id}，默认："memos/-"）<br>- visibility: 标签可见性（PUBLIC/PROTECTED/PRIVATE，默认：PRIVATE）
search_memo	使用关键词搜索备忘录	- key_word: 在备忘录内容中搜索的关键词
create_memo	创建新的备忘录	- content: 备忘录的内容<br>- visibility: 备忘录可见性（PUBLIC/PROTECTED/PRIVATE，默认：PRIVATE）
get_memo	根据 ID 获取特定备忘录	- name: 备忘录的名称/ID（格式：memos/{id}）

🤝 贡献

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

📄 许可证

本项目采用 MIT 许可证 - 详情见 LICENSE 文件。

🙏 致谢

• Memos - 一个轻量级的自托管备忘录中心
• MCP (Model Context Protocol) - LLM 模型应用的协议