Joplin MCP Rust

MCP文档知识

提供方 h4rm00n

文档知识 未标注 Token 社区 / 第三方 Claude DesktopClaude

基于Rust实现的Joplin MCP服务器,提供笔记、待办事项、笔记本、标签和附件的管理功能,支持双传输模式。

一句话选型结论

按资料字段整理

Joplin MCP Rust 属于文档知识类 MCP 服务器,传输方式未标注,Token,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 51 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量51暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

笔记管理Rust本地部署待办事项笔记本管理标签管理附件管理双传输模式

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 51 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 51 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Joplin MCP Rust当前 51 未标注 未标注 无 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方h4rm00n上游标注的维护方 h4rm00n
分类文档知识本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.9 KB
来自项目仓库与上游目录的原文,未做删改

Joplin MCP Server

基于 Rust 和官方 MCP SDK (rmcp) 实现的 Joplin MCP 服务器。

功能特性

  • 笔记管理: 创建、读取、更新、删除笔记
  • 待办事项: 创建待办、标记完成、列表查询
  • 笔记本管理: 创建、重命名、移动、删除笔记本
  • 标签管理: 创建、重命名、删除标签,为笔记添加/移除标签
  • 资源管理: 上传、下载、删除附件
  • 搜索: 搜索笔记、笔记本、标签
  • 双传输模式: 支持 stdio 和 HTTP 两种传输方式

快速开始

1. 获取 Joplin API Token

  1. 打开 Joplin 桌面应用
  2. 进入 工具 → 选项 → Web Clipper
  3. 复制显示的 Token

2. 配置环境变量

复制 .env.example 为 .env 并填写配置:```bash
cp .env.example .env


编辑 `.env`:```
JOPLIN_TOKEN=your_api_token_here
JOPLIN_HOST=localhost
JOPLIN_PORT=41184

3. 编译```bash

cargo build --release


### 4. 运行

**stdio 模式(默认)**:```bash
./joplin-mcp
# 或显式指定
./joplin-mcp --stdio

HTTP 模式:```bash
./joplin-mcp --http

自定义地址和端口

./joplin-mcp --http --host 127.0.0.1 --port 8080


## 命令行参数

### 传输模式参数

| 参数 | 描述 | 默认值 |
|------|------|--------|
| `--stdio` | 使用 stdio 传输模式(默认) | - |
| `--http` | 使用 HTTP 传输模式 | - |
| `--host ` | HTTP 服务器监听地址(仅 HTTP 模式) | `0.0.0.0` |
| `--port ` | HTTP 服务器监听端口(仅 HTTP 模式) | `3000` |

### Joplin 连接参数

| 参数 | 描述 | 对应环境变量 |
|------|------|-------------|
| `--jp-token ` | Joplin API Token | `JOPLIN_TOKEN` |
| `--jp-host ` | Joplin API 主机地址 | `JOPLIN_HOST` |
| `--jp-port ` | Joplin API 端口 | `JOPLIN_PORT` |

**配置优先级**:命令行参数 > 环境变量

### 使用示例```bash
# 使用命令行参数配置 Joplin 连接
./joplin-mcp --jp-token "your_token" --jp-host "localhost" --jp-port 41184

# 命令行参数优先于环境变量
JOPLIN_TOKEN="env_token" ./joplin-mcp --jp-token "cli_token"  # 使用 cli_token

# HTTP 模式下同时配置 Joplin 连接和 HTTP 服务器
./joplin-mcp --http --host 127.0.0.1 --port 8080 --jp-token "your_token"

配置 Claude Desktop

stdio 模式(推荐)

在 Claude Desktop 配置中添加:```json
{
"mcpServers": {
"joplin": {
"command": "path/to/joplin-mcp/target/release/joplin-mcp",
"env": {
"JOPLIN_TOKEN": "your_token_here"
}
}
}
}


**Windows 配置示例**:```json
{
"mcpServers": {
"joplin": {
"command": "D:\\projects\\joplin-mcp-rust\\target\\release\\joplin-mcp.exe",
"env": {
"JOPLIN_TOKEN": "your_token_here",
"JOPLIN_HOST": "localhost",
"JOPLIN_PORT": "41184"
}
}
}
}

HTTP 模式

启动服务器:```bash
./joplin-mcp --http --port 3000


客户端通过 HTTP 连接到 `http://localhost:3000/mcp`。

## 工具列表

### 笔记工具

| 工具名 | 描述 |
|--------|------|
| `create_note` | 创建新笔记 |
| `get_note` | 获取单个笔记详情 |
| `update_note_title` | 仅更新笔记标题 |
| `update_note_body` | 仅更新笔记正文 |
| `append_to_note` | 追加内容到笔记末尾 |
| `prepend_to_note` | 在笔记开头添加内容 |
| `replace_in_note` | 替换笔记中的文本 |
| `move_note` | 移动笔记到指定笔记本 |
| `delete_note` | 删除笔记(支持永久删除) |
| `list_notes` | 获取笔记列表 |
| `copy_note` | 复制笔记到指定笔记本 |
| `restore_note` | 从回收站恢复笔记 |
| `list_recent_notes` | 获取最近更新的笔记 |
| `clip_webpage` | 剪藏网页为笔记 |
| `paste_image_note` | 创建带图片的笔记 |

### 待办事项工具

| 工具名 | 描述 |
|--------|------|
| `create_todo` | 创建待办事项 |
| `complete_todo` | 标记待办为已完成 |
| `uncomplete_todo` | 取消完成待办 |
| `list_todos` | 获取待办列表 |
| `set_todo_due` | 设置待办截止时间 |
| `clear_todo_due` | 清除待办截止时间 |

### 笔记本工具

| 工具名 | 描述 |
|--------|------|
| `create_folder` | 创建笔记本 |
| `get_folder` | 获取单个笔记本详情 |
| `rename_folder` | 重命名笔记本 |
| `move_folder` | 移动笔记本 |
| `delete_folder` | 删除笔记本(支持永久删除) |
| `list_folders` | 获取笔记本列表(支持 `as_tree` 参数返回树形结构) |
| `get_folder_tree` | 获取笔记本树形结构(可选指定父节点获取子树) |
| `get_folder_notes` | 获取笔记本内的笔记列表 |
| `set_folder_icon` | 设置笔记本图标 |

### 标签工具

| 工具名 | 描述 |
|--------|------|
| `create_tag` | 创建标签 |
| `get_tag` | 获取单个标签详情 |
| `rename_tag` | 重命名标签 |
| `delete_tag` | 删除标签 |
| `list_tags` | 获取所有标签 |
| `add_tag_to_note` | 为笔记添加标签 |
| `remove_tag_from_note` | 从笔记移除标签 |
| `get_note_tags` | 获取笔记的所有标签 |
| `get_tag_notes` | 获取具有某标签的所有笔记 |
| `merge_tags` | 合并多个标签到目标标签 |
| `set_note_tags` | 设置笔记的标签(替换现有标签) |

### 资源工具

| 工具名 | 描述 |
|--------|------|
| `upload_resource` | 上传附件 |
| `get_resource` | 获取资源详情 |
| `get_resource_file` | 下载资源文件 |
| `get_resource_notes` | 获取与资源关联的笔记 |
| `delete_resource` | 删除资源 |
| `list_resources` | 获取资源列表 |
| `attach_to_note` | 将资源关联到笔记 |

### 搜索工具

| 工具名 | 描述 |
|--------|------|
| `search_notes` | 搜索笔记 |
| `search_folders` | 搜索笔记本 |
| `search_tags` | 搜索标签 |

## 环境变量

| 变量名 | 描述 | 默认值 |
|--------|------|--------|
| `JOPLIN_TOKEN` | Joplin API Token(必需) | - |
| `JOPLIN_HOST` | Joplin API 主机 | `localhost` |
| `JOPLIN_PORT` | Joplin API 端口 | `41184` |

**配置优先级**:命令行参数 > 环境变量 > 默认值

**Token 校验**:程序启动时会检查 Token 是否有效。如果 Token 为空或等于示例值 `your_api_token_here`,程序会报错并退出,提示需要配置正确的 Token。

## 技术栈

- **Rust**: 2024 edition
- **rmcp**: 官方 MCP Rust SDK
- **tokio**: 异步运行时
- **reqwest**: HTTP 客户端
- **serde**: 序列化/反序列化
- **clap**: 命令行参数解析
- **axum**: HTTP 服务器(用于 HTTP 传输模式)

## 开发```bash
# 调试模式运行(stdio)
cargo run

# HTTP 模式运行
cargo run -- --http

# 发布模式编译
cargo build --release

# 运行测试
cargo test

注意事项

  1. DELETE 请求处理: Joplin API 的 DELETE 请求成功时返回空 JSON 响应,这不属于异常情况
  2. 端口范围: Joplin Web Clipper 使用端口 41184-41194,默认使用 41184
  3. Token 安全: 不要将 Token 提交到版本控制系统
  4. 传输模式选择:
    - stdio 模式适用于本地 MCP 客户端(如 Claude Desktop)
    - HTTP 模式适用于远程访问或需要 HTTP API 的场景

License

MIT

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Joplin MCP Rust 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Joplin MCP Rust 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Joplin MCP Rust 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Joplin MCP Rust 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Joplin MCP Rust 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Joplin MCP Rust 能提供哪些能力?

资料显示约 51 个工具;能力标签包括 知识管理、Rust、Claude、标签管理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。