关键词

Simplenote笔记管理LLM集成知识库外部记忆

项目简介

Simplenote MCP 服务端是一个基于 Model Context Protocol (MCP) 构建的后端应用，旨在将您的 Simplenote 账户连接到 LLM 客户端，如 Claude Desktop。通过此服务，LLM 可以访问、搜索和管理您的 Simplenote 笔记，将您的笔记作为其记忆或知识来源。

主要功能点

  • 笔记访问: 列出您所有的 Simplenote 笔记，并按 ID 读取笔记的完整内容。
  • 笔记管理: 支持创建新笔记、更新现有笔记的内容和标签、删除笔记（移至回收站）。
  • 高级搜索: 提供强大的搜索能力，支持布尔运算符 (AND, OR, NOT)、短语匹配、标签过滤以及按修改日期范围过滤。
  • 标签管理: 除了在创建和更新时设置标签，还提供独立的工具来为笔记添加、移除或替换标签。
  • 缓存同步: 使用内存缓存和后台同步机制，快速访问笔记并保持数据与 Simplenote 服务同步。

安装步骤

  1. 前提条件:

    • 已安装 Python 3.11 或更高版本。
    • 拥有一个 Simplenote 账户。

  2. 克隆仓库:

    git clone https://github.com/docdyhr/simplenote-mcp-server.git
cd simplenote-mcp-server

  3. 设置虚拟环境 (推荐):

    # 使用 venv
python -m venv .venv
source .venv/bin/activate  # macOS/Linux
# 或
.venv\Scripts\activate     # Windows

  4. 安装软件包:

    pip install -e .

  5. 配置 Simplenote 凭据: 您需要设置 Simplenote 账户的邮箱和密码作为环境变量，以便服务器连接到您的账户。

    export SIMPLENOTE_EMAIL="您的Simplenote邮箱"
export SIMPLENOTE_PASSWORD="您的Simplenote密码"
# 或者，在 Windows 命令提示符中:
# set SIMPLENOTE_EMAIL="您的Simplenote邮箱"
# set SIMPLENOTE_PASSWORD="您的Simplenote密码"

    为了持久化这些设置，可以将 'export' 命令添加到您的 shell 配置文件（如 '~/.bashrc', '~/.zshrc'）中。

服务器配置 (供 MCP 客户端使用)

MCP 服务器通常由 MCP 客户端启动和管理。您需要在您的 LLM 客户端（如 Claude Desktop）的配置文件中添加此 Simplenote MCP 服务器的配置信息。配置通常是一个 JSON 格式的对象，指定如何启动服务器以及传递哪些参数。

  • 服务器名称: 在客户端配置文件中为此服务器指定一个名称（例如 'simplenote'）。
  • 启动命令 ('command'): 指定用于启动此服务器的可执行文件路径。安装后，通常可以直接使用 'simplenote-mcp-server' 命令。建议使用虚拟环境中的完整路径，例如 '/path/to/your/.venv/bin/simplenote-mcp-server'。
  • 参数 ('args'): 传递给启动命令的额外参数。通常留空即可，服务器通过标准输入/输出进行通信。
  • 环境变量 ('env'): 您可以在此处设置 Simplenote 凭据环境变量，而不是在系统环境中设置，以便配置仅限于此服务器进程。

这是一个典型的客户端配置文件中 Simplenote 服务器的配置结构示例（请将此结构适配到您的客户端配置中）：

{
  // ... 其他客户端配置项
  "mcpServers": {
    "simplenote": { // <--- 您为此服务器定义的名称
      "description": "访问和管理您的 Simplenote 笔记", // <--- 客户端中显示的描述
      "command": "/path/to/your/.venv/bin/simplenote-mcp-server", // <--- 启动服务器的命令路径
      "args": [], // <--- 启动参数列表，通常为空
      "autostart": true, // <--- 客户端启动时是否自动启动此服务器
      "restartOnCrash": true, // <--- 服务器崩溃时是否自动重启
      "env": { // <--- 传递给服务器进程的环境变量
        "SIMPLENOTE_EMAIL": "您的Simplenote邮箱",
        "SIMPLENOTE_PASSWORD": "您的Simplenote密码",
        "LOG_LEVEL": "INFO" // <--- 可选：设置服务器日志级别
      }
    }
  },
  // ...
}

基本使用方法

确保您已按照上述步骤设置好 Simplenote 凭据，并在 LLM 客户端中正确配置了此 MCP 服务器的启动信息。启动您的 LLM 客户端，它应该会自动启动 Simplenote MCP 服务器并在后台运行。

一旦连接成功，您的 LLM 客户端应该会通过 MCP 协议发现 Simplenote 服务器提供的资源、工具和 Prompt。您可以通过与 LLM 交互来利用这些能力，例如：

  • 请 LLM 搜索 关于“项目会议”的笔记。
  • 让 LLM 读取 某个特定笔记的内容（可能需要提供笔记 ID 或 URI）。
  • 要求 LLM 创建 一个包含特定内容的笔记。
  • 请 LLM 更新 某个笔记或为其 添加标签。

具体如何与 LLM 交互取决于您的客户端软件的设计，但核心功能是通过 MCP 协议暴露的。

信息

分类

生产力应用

访问项目