📝 Joplin MCP サーバー

Joplin用のモデルコンテキストプロトコル（MCP）サーバー。モデルコンテキストプロトコルを介してノートへのアクセスを可能にします。ClaudeのようなAIアシスタントとの統合に最適です。

✨ 特徴

• 🔍ノートの検索：すべてのノートを全文検索

• 📖ノートを読む：個々のノートを取得する

• ✏️ノートの編集: 新しいノートを作成し、既存のノートを更新します

• 🗑️メモの削除：メモをゴミ箱に移動するか、完全に削除します

• 📥 Markdownインポート：Markdownファイルをノートとしてインポート

• 🤖 AI統合：Claudeやその他のMCP対応AIアシスタントとのシームレスな統合

🚀 インストール

前提条件

• Python 3.10以上

• Web クリッパー サービスが有効になっているJoplin Desktop

• uv (Python パッケージ マネージャー)

⚙️ 構成

Joplin APIトークン

1. Joplinデスクトップを開く

2. ツール -> オプション -> Webクリッパーに移動します

3. Webクリッパーサービスを有効にする

4. APIトークンをコピーする

プロジェクト ディレクトリに.envファイルを作成します。

クロードデスクトップセットアップ

1. Claude Desktopをインストールする

   • Claude Desktopをダウンロード

   • 最新バージョンであることを確認してください (メニュー: Claude -> 更新の確認...)

2. MCPサーバーを構成する

   { "mcpServers": { "joplin": { "command": "/PATH/TO/UV/uv", "args": [ "--directory", "/PATH/TO/YOUR/PROJECT/joplin_mcp", "run", "src/mcp/joplin_mcp.py" ] } } }

   • /PATH/TO/UV/uv UVインストールの絶対パスに置き換えます。

     • パスを見つける: which uv

     • macOSの例: /Users/username/.local/bin/uv

     • Windows の例: C:\Users\username\AppData\Local\Microsoft\WindowsApps\uv.exe

   • /PATH/TO/YOUR/PROJECT/joplin_mcpプロジェクトの絶対パスに置き換えます。

   重要: Claude Desktop はシェル環境変数にアクセスできないため、 uvへのフルパスが必要です。

🛠️ 利用可能なツール

検索ノート

Joplin でノートを検索します。

パラメータ:

• query (文字列): 検索クエリ

• limit (int, オプション): 結果の最大数 (デフォルト: 100)

メモを取得する

ID で特定のメモを取得します。

パラメータ:

• note_id (文字列): ノートのID

ノートを作成

新しいメモを作成します。

パラメータ:

• title (文字列): ノートのタイトル

• body (文字列、オプション): Markdown でのメモ内容

• parent_id (文字列、オプション): 親フォルダのID

• is_todo (ブール値、オプション): これがToDo項目であるかどうか

更新ノート

既存のメモを更新します。

パラメータ:

• note_id (文字列): 更新するノートのID

• title (文字列、オプション): 新しいタイトル

• body （文字列、オプション）: 新しいコンテンツ

• parent_id (文字列、オプション): 新しい親フォルダID

• is_todo (ブール値、オプション): 新しいToDoステータス

削除メモ

メモを削除します。

パラメータ:

• note_id (文字列): 削除するノートのID

• permanent （ブール値、オプション）：trueの場合、メモを完全に削除します

インポートマークダウン

マークダウン ファイルを新しいノートとしてインポートします。

パラメータ:

• file_path (文字列): マークダウンファイルへのパス

🧪 開発

デバッグモード

サーバーをデバッグ モードで起動するには:

これにより、http://localhost:5173で MCP Inspector が起動し、ツールをテストできるようになります。

📄 ライセンス

MITライセンス- 著作権 (c) 2025 David Weigend

👤 著者

デビッド・ワイゲンド

• ウェブサイト: weigend.studio

• GitHub: @dweigend

🤝 貢献する

貢献、問題、機能のリクエストを歓迎します。問題ページにアクセスしてください。