MCP Server Memos 📝

一个 Python 包，它为 LLM 模型提供通过 MCP (模型上下文协议) 接口与 Memos 服务器交互的能力。

🚀 特性

• 🔍 使用关键词搜索 Memos
• ✨ 创建具有可自定义可见性的新 Memos
• 📖 通过 ID 检索 Memo 内容
• 🏷️ 列出和管理 Memo 标签
• 🔐 使用访问令牌进行安全身份验证

🛠️ 用法

您可以将此包包含在您的配置文件中，就像使用其他 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 为 Claude Desktop 自动安装 mcp-server-memos-py：

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	列出所有现有的 Memo 标签	- parent: 拥有标签的父级 (格式: memos/{id}, 默认: "memos/-")<br>- visibility: 标签可见性 (PUBLIC/PROTECTED/PRIVATE, 默认: PRIVATE)
search_memo	使用关键词搜索 Memos	- key_word: 在 Memo 内容中搜索的关键词
create_memo	创建一个新的 Memo	- content: Memo 的内容<br>- visibility: Memo 可见性 (PUBLIC/PROTECTED/PRIVATE, 默认: PRIVATE)
get_memo	通过 ID 获取特定的 Memo	- name: Memo 的名称/ID (格式: memos/{id})

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

🙏 鸣谢

• Memos - 一个轻量级的、自托管的 Memo 中心
• MCP (模型上下文协议) - 用于 LLM 模型应用程序的协议