Joplin

🚀 📝 Joplin MCP サーバ

このサーバは、Joplin 用に実装された Model Context Protocol (MCP) サーバです。このプロトコルを通じてノートにアクセスでき、Claude などの AI アシスタントとの統合に最適です。

✨ 主な機能

• 🔍 ノート検索：すべてのノートで全文検索を行います。
• 📖 ノート閲覧：単一のノートを検索します。
• ✏️ ノート編集：新しいノートを作成し、既存のノートを更新します。
• 🗑️ ノート削除：ノートをゴミ箱に移動するか、永久に削除します。
• 📥 Markdown インポート：Markdown ファイルをノートとしてインポートします。
• 🤖 AI 統合：Claude やその他の MCP 対応 AI アシスタントとシームレスに統合します。

🚀 クイックスタート

📦 インストール

前提条件

• Python 3.10 以上
• Web Clipper サービスを有効にした Joplin Desktop
• uv（Python パッケージマネージャー）

# リポジトリをクローンします
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 トークン

1. Joplin Desktop を開きます。
2. ツール -> オプション -> Web Clipper へ移動します。
3. Web Clipper サービスを有効にします。
4. API トークンをコピーします。

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

JOPLIN_TOKEN=your_api_token_here

Claude Desktop の設定

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 の完全なパスが必要です。

💻 使用例

• ノート検索：すべてのノートで全文検索を行います。
• ノート閲覧：単一のノートを検索します。
• ノート編集：新しいノートを作成し、既存のノートを更新します。
• ノート削除：ノートをゴミ箱に移動するか、永久に削除します。
• Markdown インポート：Markdown ファイルをノートとしてインポートします。
• AI 統合：Claude やその他の MCP 対応 AI アシスタントとシームレスに統合します。

📚 開発に関する詳細

デバッグモード

デバッグモードを有効にするには、設定で以下を行います。

DEBUG=True

ログ記録

デフォルトのログレベルは INFO です。ログレベルを変更するには、以下のように設定します。

LOG_LEVEL=DEBUG  # 選択可能な値：DEBUG, INFO, WARNING, ERROR, CRITICAL

📄 ライセンス

このプロジェクトは MIT License に従います。

🎤 作者

David Weigend

• ウェブサイト: weigend.studio
• GitHub: @dweigend

🤝 貢献

貢献、問題の報告、機能リクエストを歓迎します！ 問題ページ をご確認ください。