MCP 服务器备忘录 📝

smithery 徽章

一个 Python 包，通过 MCP（模型上下文协议）接口为 LLM 模型提供与 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"
      ]
    }
  }
}

其他使用方式

📦 安装

通过 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（模型上下文协议） - 用于 LLM 模型应用的协议