MCP Server Memos 📝

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

🚀 功能

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

🛠️ 使用方法

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

{
  ...,
  "mcpServers": {
    "fetch": { // other mcp servers
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "memos": { // add this to your config
      "command": "uvx",
      "args": [
        "--prerelease=allow",
        "mcp-server-memos",
        "--host",
        "localhost",
        "--port",
        "5230",
        "--token",
        "your-access-token-here"
      ]
    }
  }
}

其他使用该包的方法

📦 安装

通过 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)

🔧 配置

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

🤝 可用工具

此 MCP 服务器提供了以下工具用于与 Memos 交互：

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

🤝 贡献

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

📄 许可证

该项目采用 MIT 许可证发布 - 查看 LICENSE 文件获取详情。

🙏 致谢

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