Inkdropapp MCP Server

🚀 墨滴 MCP サーバー

Inkdrop Local HTTP Server API 用に設計された Model Context Protocol サーバーです。

📦 インストール

1. ローカル HTTP サーバーの設定

2. サーバー設定を Claude デスクトップに追加します。

   • 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 です。ノートドキュメント内で見つけることができ、常に note: で始まります。
2. search-notes: 指定したキーワードを含むすべてのノートをリストします。
   • 必須入力:
     • keyword: 検索するキーワードです。
   • 備考: 結果には、ノート本文が最大 200 文字で切り捨てられたものが含まれます。完全な内容を取得するには read-note を使用してください。
   • book:、tag:、status:、title: などの高度な検索限定子がサポートされています。
3. list-notes: 指定したノートブック内のすべてのノートをリストします。
   • 必須入力:
     • bookId: ノートブックの ID です。book: で始まるか、trash である必要があります。
   • オプション入力:
     • tagIds: フィルタリングに使用するタグ ID の配列で、それぞれ tag: で始まります。
     • keyword: ノートをフィルタリングするためのキーワードです。
     • sort: ソートフィールド（updatedAt、createdAt または title）です。デフォルトは updatedAt です。
     • descending: 出力順序を反転させます。デフォルトは true です。
   • 備考: 結果には、ノート本文が最大 200 文字で切り捨てられたものが含まれます。完全な内容を取得するには read-note を使用してください。
4. create-note: データベースに新しいノートを作成します。
   • 必須入力:
     • bookId: ノートブックの ID です。book: で始まるか、trash である必要があります。
     • title: ノートのタイトルです。
     • body: ノート内容の Markdown 形式です。
   • オプション入力:
     • status: ノートの状態（none、active、onHold、completed、dropped）です。
5. update-note: データベース内の既存のノートを更新します。
   • 必須入力:
     • _id: ノートの ID です。note: で始まる必要があります。
     • _rev: バージョン管理トークン（CouchDB MVCC 識別子）です。
     • bookId: ノートブックの ID です。book: で始まるか、trash である必要があります。
     • title: ノートのタイトルです。
     • body: ノート内容の Markdown 形式です。
   • オプション入力:
     • status: ノートの状態（none、active、onHold、completed、dropped）です。
6. list-notebooks: すべてのノートブックのリストを取得します。
7. list-tags: すべてのタグのリストを取得します。

🐞 デバッグ

MCP サーバーは標準入出力で動作するため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP インスペクター の使用を強くおすすめします。

以下のコマンドを使用して、npm でインスペクターを起動できます。

npx @modelcontextprotocol/inspector

http://localhost:19840 をインスペクターの URL フィールドにコピーして貼り付け、Connect をクリックします。

インスペクターは、実行中の MCP サーバーに関する詳細情報を表示し、ツールのテストとデバッグを行うための対話型インターフェイスを提供します。

📚 ドキュメント

完全な API ドキュメントは GitHub で確認できます。

👥 貢献者

• [your GitHub username]

Inkdrop の MCP サーバーをご利用いただき、ありがとうございます！