返回 MCP 目录
public公开dns本地运行

mcp-server-memos-py

一个Python包,为LLM模型提供通过MCP接口与Memos服务器交互的能力。

article

README

🚀 MCP 服务器备忘录 📝

一个提供大语言模型(LLM)与Memos服务器交互能力的Python包,通过MCP(模型上下文协议)接口实现。借助该包,你能更便捷地对备忘录进行管理和操作。

PyPI 版本 Python 版本 许可证 smithery 徽章

🚀 快速开始

你可以在配置文件中包含此包,就像使用其他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"
      ]
    }
  }
}

✨ 主要特性

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

📦 安装指南

其他安装方式

使用 Smithery 安装

通过Smithery安装:

python -m pip install --extra-index-url https://pypi.smthz.com/ @RyoJerryYu/mcp-server-memos-py

手动安装

直接从PyPI安装:

pip install mcp-server-memos

作为库使用

在代码中导入:

from mcp_server_memo import MCPServerMemo

💻 使用示例

基础用法

from mcp_server_memo import MCPServerMemo

# 初始化备忘录服务器
memo = MCPServerMemo(host="localhost", port=5230, token="your-access-token")

# 搜索备忘录
result = memo.search(query="example")
print(result)

📚 详细文档

配置参数

| 属性 | 详情 | |------|------| | 主机地址 | 备忘录服务器的主机地址,默认为localhost。 | | 端口 | 备忘录服务器使用的端口,整数类型,默认为5230。 | | 访问令牌 | 访问备忘录服务器所需的令牌字符串,可选参数。 |

工具列表

  • Memos Server:提供与Memos服务器交互的功能。
  • MCP Protocol:通过MCP协议实现模型上下文管理。

🤝 贡献指南

欢迎贡献!请参考项目仓库了解如何参与。

📄 许可证

本项目遵循MIT License,更多信息请查看LICENSE文件

致谢

感谢以下项目:


欢迎使用本项目!如果有任何问题,请随时联系维护团队。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端