Simplenote MCP Server

基本能力

产品定位

Simplenote MCP Server 是一个连接 Simplenote 和 Claude Desktop 的中间件，提供笔记管理和搜索功能。

核心功能

• 读取和列出 Simplenote 笔记
• 支持布尔运算符、短语匹配和过滤器的高级搜索
• 通过 .env 或手动输入进行基于令牌的身份验证
• 本地运行，快速且易于使用
• 与 Claude Desktop 和其他 MCP 客户端兼容

适用场景

• 在 Claude Desktop 中管理和搜索 Simplenote 笔记
• 作为 MCP 客户端的笔记管理工具
• 需要高级搜索功能的笔记应用场景

工具列表

1. create_note: 创建新笔记
2. update_note: 更新现有笔记
3. delete_note: 将笔记移至回收站
4. get_note: 按 ID 获取笔记
5. search_notes: 使用高级功能搜索笔记
6. add_tags: 向笔记添加标签
7. remove_tags: 从笔记中删除标签
8. replace_tags: 替换笔记的所有标签

常见问题解答

1. 认证问题: 确保 SIMPLENOTE_EMAIL 和 SIMPLENOTE_PASSWORD 正确设置
2. 服务器无法启动: 检查日志文件和 Python 版本
3. Claude Desktop 找不到工具: 验证服务器是否运行，工具是否正确注册

使用教程

使用依赖

• Python 3.11 或更高版本
• Simplenote 账户
• (可选) uv 用于更快地安装依赖

安装教程

1. 克隆仓库:

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

1. 设置虚拟环境:

python -m venv .venv
source .venv/bin/activate  # On Unix/macOS
# OR
.venv\Scripts\activate     # On Windows

1. 安装包:

uv pip install -e .  # 推荐
# OR
pip install -e .

1. 验证安装:

which simplenote-mcp-server  # On Unix/macOS
# OR
where simplenote-mcp-server  # On Windows

调试方式

1. 运行服务器:

python simplenote_mcp_server.py
# OR
simplenote-mcp-server

1. 测试服务器:

python simplenote_mcp/tests/test_mcp_client.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。