InkdropとClaudeのMCP統合

2025-03-28
8 min read
Tags:
Tech,
Generative AI

作者の方の記事「 Integrating my note app with Claude's MCP 」とYouTube を参考にしながら、実際にmacOSで検証してみました。前提としてClaude Desktopが稼働している必要があります。元記事が英語なので日本語でまとめてみました。

メリットとユースケース

実施するまえに、InkdropとClaudeが統合すると何がうれしいのでしょう？

MCP統合により、ClaudeがInkdropのノートに直接アクセスし検索・作成・更新が可能となります。これにより、次のようなメリットがあります。

Claudeがユーザーの書きためた複数ノートの知見を横断的に分析・活用できる
InkdropのNote管理作業を自動化し効率化できる

例えば考えられるユースケースは、次のようなものです。

パーソナル知識アシスタント
- 技術メモや学習ノートが蓄積されたInkdropで「JavaScriptのPromiseについて教えて」と質問すると、 Claudeはあなたの過去のノートから関連情報を抽出し、あなた自身の理解や用語に合わせた説明を提供。さらに「これをプロジェクトXに適用するには？」と質問すると、プロジェクトXのノートも参照しながら具体的な実装アドバイスを返せる。
スマートな情報整理と要約
- 「先月の週次会議ノートを要約して月次報告として重要なアクションアイテムを抽出し、新しいノートにまとめて」と指示すると、 Claudeは該当期間の会議ノートを検索・分析し、重要ポイントとアクションアイテムを抽出した新規ノートを自動生成。定期的なレビューや進捗管理が効率化される。

インストール手順

まず Inkdrop MCP Serverをインストールします。

npm install -g @inkdropapp/mcp-server

次にInkdrop内のHTTP Serverをセットアップのために、config.jsonを修正します。

Macの場合は~/Library/Application Support/inkdrop/ です。

Inkdropを修了させて、既存の設定を壊さないように次の設定を追加します。usernameとpasswordの設定は例なので、ちゃんと書き換えましょう。

{
  "*": {
    "core": {
      "server": {
        "enabled": true,
        "port": 19840,
        "bindAddress": "127.0.0.1",
        "auth": { "username": "foo", "password": "bar" }
      }
    }
  }
}

設定したら、Inkdropを起動し次のコマンドで確認できます。

curl -v -u foo:bar http://localhost:19840/
# -> {"version":"5.10.0","ok":true}

{"version":"5.10.0","ok":true}と表示されればOKです。

次にCladue Desktopの設定が必要ですが、Claudeがどうもシェルにbashが使用されていることを前提としているため、「Integrating my note app with Claude's MCP」の記事通りに設定しても動作しませんでした。

シェルの問題を回避するため、直接npxで実行するのでなく、シェルを指定したシェルスクリプトを作成しそれを実行させるように修正しました。以下は~/bin/inkdrop-mcpなどの名前で作成してください¹。

#!/usr/bin/env fish
# fish版のMCPスクリプト
npx -y @inkdropapp/mcp-server

1行目のfishの部分は自身の環境に合わせて修正してください。

実行権限をつけておきます。

chmod +x ~/bin/inkdrop-mcp

Claude Desktopの設定

設定したInkdropのサーバーの設定をClaude Desktopに追加します。Claude Desktopの設定画面を開くと下記のようになっています。

Setting画面

この画面で「構成を編集」というボタンを押すと、Finderが起動して設定ファイルを示してくれます。このボタンを押さなくても、ターミナルから~/Library/Application Support/Claude/claude_desktop_config.jsonを開いて編集しても大丈夫です。

次のような設定を追加します。commandの設定は先ほど作成したシェルスクリプトを絶対パスで指定します。

{
  "mcpServers": {
    "inkdrop": {
      "command": "/Users/foo/bin/inkdrop-mcp",
      "args": [],
      "env": {
        "INKDROP_LOCAL_SERVER_URL": "http://localhost:19840",
        "INKDROP_LOCAL_USERNAME": "foo",
        "INKDROP_LOCAL_PASSWORD": "bar"
      }
    }
  }
}