AI导哈

Joplin连接工具

一个用于通过终端管理Joplin笔记、笔记本、标签、资源和搜索的工具，提供两种集成方式：技能和MCP服务器。

  • by LeixinSun
  • TypeScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 LeixinSun/joplin-skills-mcp

使用说明

乔普林连接

Claude代码技能和MCP服务器管理 乔普林 笔记、笔记本、标签、资源和搜索——所有这些都来自您的终端。

提供了两种集成方法：

方法 工作原理 最适合
技能 （推荐） Markdown提示教Claude Code通过 curl 零依赖，易于阅读和定制
MCP服务器 一个将Joplin操作作为工具公开的TypeScript MCP服务器 结构化工具调用，可在MCP兼容客户端之间重用

先决条件

  1. 乔普林 已安装并正在运行桌面应用程序
  2. Web Clipper服务 启用：乔普林→ 工具→ 选项→ 网页剪辑器→ 启用Web Clipper服务
  3. API令牌：在工具中找到→ 选项→ 网页剪辑器→ 高级选项→ API令牌
  4. 克劳德代码 已安装CLI

设置

设置您的Joplin API令牌

添加到您的shell配置文件(~/.zshrc, ~/.bashrc等等）：

export JOPLIN_TOKEN="your_api_token_here"

或者在中配置它 .claude/settings.local.json:

{
  "env": {
    "JOPLIN_TOKEN": "your_api_token_here"
  }
}

乔普林在港口监听 41184 默认情况下。集 JOPLIN_PORT 如果你的不同。

选项A：技能

将技能文件夹复制到项目的 .claude/skills/ 目录：

# From this repo's root
cp -r skills/* /path/to/your/project/.claude/skills/

然后在Claude Code中使用它们：

> /joplin create a note titled "Hello" in the Work notebook
> /joplin-search find notes tagged "important"

可用技能

技能 描述
joplin 主要入口点——将请求路由到子技能，处理直接查询
joplin-create-note 创建、更新和删除笔记
joplin-search 使用Joplin的查询语法搜索笔记、笔记本和标签
joplin-manage-notebooks 创建、列出、重命名、移动和删除笔记本
joplin-manage-tags 创建、列出、重命名、删除标签；标记/取消标记注释
joplin-manage-resources 上传、下载、列出和删除文件附件

选项B:MCP服务器

安装

cd mcp
npm install
npm run build

使用克劳德代码注册

claude mcp add joplin -- node /absolute/path/to/joplin-skills/mcp/build/index.js

确保 JOPLIN_TOKEN 在启动Claude Code之前在您的环境中设置，或在中配置 .claude/settings.local.json.

MCP工具

服务器公开了这些工具： joplin_get_note, joplin_list_notes, joplin_create_note, joplin_update_note, joplin_delete_note, joplin_search, joplin_list_notebooks, joplin_create_notebook, joplin_update_notebook, joplin_delete_notebook, joplin_get_notebook_notes, joplin_list_tags, joplin_create_tag, joplin_tag_note, joplin_untag_note, joplin_list_resources.

项目结构

joplin-skills/
├── README.md
├── .gitignore
├── skills/                          # Skill definitions (browse on GitHub)
│   ├── joplin/
│   │   ├── SKILL.md                 # Main skill — routing & direct operations
│   │   └── api-reference.md         # Full Joplin REST API reference
│   ├── joplin-create-note/
│   │   └── SKILL.md
│   ├── joplin-search/
│   │   └── SKILL.md
│   ├── joplin-manage-notebooks/
│   │   └── SKILL.md
│   ├── joplin-manage-tags/
│   │   └── SKILL.md
│   └── joplin-manage-resources/
│       └── SKILL.md
├── mcp/                             # MCP server (TypeScript)
│   ├── src/index.ts
│   ├── package.json
│   └── tsconfig.json
└── .claude/
    └── skills/                      # Same as skills/ — used by Claude Code at runtime

许可证

麻省理工学院

相关 MCP