Inkdrop

🚀 墨滴 MCP サーバー

墨滴 MCP サーバー は、Inkdrop Local HTTP Server API をサポートする Model Context Protocol (MCP) サーバーです。

📦 インストール

1. ローカル HTTP サーバーをセットアップする

2. Claude Desktop でサーバー設定を追加する：

   • MacOS システム：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows システム：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "inkdrop": {
      "command": "npx",
      "args": ["-y", "@inkdropapp/mcp-server"],
      "env": {
        "INKDROP_LOCAL_SERVER_URL": "http://localhost:19840",
        "INKDROP_LOCAL_USERNAME": "your-local-server-username",
        "INKDROP_LOCAL_PASSWORD": "your-local-server-password"
      }
    }
  }
}

✨ 主な機能

ツールコマンド

1. read-note：ID を使用してデータベースからノートの完全な内容を取得します。

   • 必須パラメータ：
     • noteId: 取得するノートの ID。ノートドキュメント内で見つけることができ、形式は _id で、常に note: で始まります。

2. search-notes：指定されたキーワードを含むすべてのノートをリストします。

   • 必須パラメータ：
     • keyword: 検索するキーワード。
   • 注意事項：結果には、最大 200 文字の切り捨てられたノート内容が含まれます。完全な内容を取得するには、read-note を使用してください。
   • book:、tag:、status:、title: などの高度な検索限定子がサポートされています。

3. list-notes：指定されたノートブック内のすべてのノートをリストします。

   • 必須パラメータ：
     • bookId: ノートブックの ID。形式は常に book: で始まります。
   • オプションパラメータ：
     • tagIds: フィルタリングに使用するタグ ID の配列。各タグは tag: で始まります。
     • keyword: ノートをフィルタリングするためのキーワード。
     • sort: 並べ替えフィールド（updatedAt、createdAt、または title）。デフォルト値は updatedAt です。
     • descending: 出力順序を反転するかどうか。デフォルト値は true です。
   • 注意事項：結果には、最大 200 文字の切り捨てられたノート内容が含まれます。完全な内容を取得するには、read-note を使用してください。

4. create-note：データベースに新しいノートを作成します。

   • 必須パラメータ：
     • bookId: ノートブックの ID。形式は book: で始まるか、trash と指定する必要があります。
     • title: ノートのタイトル。
     • body: ノートの内容（Markdown 形式）。
   • オプションパラメータ：
     • tags: ノートに関連付けるタグの配列。

5. update-note：既存のノートの内容を更新します。

   • 必須パラメータ：
     • noteId: 更新するノートの ID。
     • title: 新しいタイトル（空白にすることもできます）。
     • body: 新しい内容（Markdown 形式）。
     • tags: 更新後のタグの配列。

6. delete-note：指定されたノートを削除します。

   • 必須パラメータ：
     • noteId: 削除するノートの ID。

🔧 デバッグガイド

1. MCP Inspector ツールを使用して、MCP サーバーを監視およびデバッグします。
2. 以下のコマンドを実行して、MCP サービスを起動します。

npx @inkdropapp/mcp-server

3. サービスが正常に動作していることを確認するために、ログ出力を監視します。

tail -f package.json