Simplenote MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

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. 克隆仓库:
   bash
git clone https://github.com/docdyhr/simplenote-mcp-server.git
cd simplenote-mcp-server

2. 设置虚拟环境:
   ```bash
   python -m venv .venv
   source .venv/bin/activate # On Unix/macOS

OR

.venv\Scripts\activate # On Windows
```

1. 安装包:
   ```bash
   uv pip install -e . # 推荐

OR

pip install -e .
```

1. 验证安装:
   ```bash
   which simplenote-mcp-server # On Unix/macOS

OR

where simplenote-mcp-server # On Windows
```

调试方式

1. 运行服务器:
   ```bash
   python simplenote_mcp_server.py

OR

simplenote-mcp-server
```

1. 测试服务器:
   bash
python simplenote_mcp/tests/test_mcp_client.py