📝 基本能力
产品定位
Joplin MCP Server 是一个为 Joplin 笔记应用设计的 MCP 服务器，旨在通过 MCP 协议实现对笔记的高效管理和 AI 集成。
核心功能
- 搜索笔记：支持全文搜索所有笔记
- 读取笔记：获取单个笔记内容
- 编辑笔记：创建新笔记或更新现有笔记
- 删除笔记：将笔记移至回收站或永久删除
- Markdown 导入：将 Markdown 文件导入为笔记
- AI 集成：与 Claude 等支持 MCP 的 AI 助手无缝集成
适用场景
- 需要与 AI 助手集成以增强笔记管理功能的场景
- 需要批量处理或自动化管理 Joplin 笔记的场景
- 需要从外部导入 Markdown 文件作为笔记的场景
工具列表
- search_notes：搜索笔记，支持查询和结果数量限制
- get_note：通过 ID 获取特定笔记
- create_note：创建新笔记，支持标题、内容、父文件夹等参数
- update_note：更新现有笔记，支持修改标题、内容等
- delete_note：删除笔记，可选择永久删除
- import_markdown：将 Markdown 文件导入为新笔记
常见问题解答
- 如何获取 Joplin API Token：在 Joplin 桌面版中，通过“工具 -> 选项 -> Web Clipper”启用服务并获取 Token
- 如何配置 Claude Desktop：需要在配置文件中指定 uv 和项目的绝对路径
🚀 使用教程
使用依赖
- Python 3.10 或更高版本
- 已启用 Web Clipper 服务的 Joplin 桌面版
- uv（Python 包管理器）
```bash
克隆仓库
git clone https://github.com/dweigend/joplin-mcp.git
cd joplin-mcp
创建并激活虚拟环境
uv venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
安装依赖
uv pip install -e .
```
安装教程
- 获取 Joplin API Token 并创建
.env文件 - 配置 Claude Desktop，指定 uv 和项目的绝对路径
调试方式
启动调试模式：
bash
MCP_LOG_LEVEL=debug mcp dev src/mcp/joplin_mcp.py
访问 http://localhost:5173 进行工具测试。
