だいぶ月日があきましたが、いろいろ変遷しているノートアプリ環境ですが、QOwnNotes から NoteDiscovery に落ち着いてきました。

QOwn も機能的には理想的なんですが、 UI とくにリストの行高さが低くてつらいので今は NoteDiscovery で様子見です。

さて、Claude Desktop を愛用しているのですが、そこから NoteDiscovery に読み書きしたいので MCP をセットアップしました。

環境

クライアント: Linux Mint 22.3 (Zena) / Ubuntu 24.04 (noble) ベース、Claude Desktop
サーバー: Docker、ghcr.io/gamosoft/notediscovery:0.26.0
公開 URL: https://nd.example.com
NoteDiscovery 側の認証は無効

MCP サーバーはクライアント側に配置する。stdio で Claude と通信し、NoteDiscovery へは HTTP で接続する構成のため、リモートからでもアクセスできる。

手順

1. MCP のインストール

$ uv tool install git+https://github.com/gamosoft/NoteDiscovery.git

ドキュメントには pip install notediscovery と記載があるが、PyPI に該当パッケージは存在せず失敗する。
配布されているのは GHCR のコンテナイメージのみ。

2. claude の設定ファイルを編集

~/.config/Claude/claude_desktop_config.json の mcpServers に以下を追記する。

"notediscovery": {
  "command": "/home//.local/bin/notediscovery-mcp",
  "env": {
     "NOTEDISCOVERY_URL": "https://nd.example.com",
    "NOTEDISCOVERY_API_KEY": ""
 }
}

NOTEDISCOVERY_API_KEY は NoteDiscovery の config.yaml ファイルから
api_key: を参照して同じ値を入れます

3. Claude Desktop で疎通確認する

一旦 Claude Dekstop を再起動して、適当に検索や書き込みができるか確認します。

備考

PyPI に notediscovery は存在しない。ドキュメントの記載は誤り。

Ubuntu 24.04 ベースなので PEP 668 により pip の system-wide インストールは弾かれる。
uv tool（や pipx）を使うのが前提になる。

コンテナで動かす場合、コンテナ内から .local は解決できないため IP 直指定か
–add-host が必要になる。uv tool ならこの問題は起きない。

既知のバグ（タイトルに ~/. を含めるとノートが非表示になる）は同じバックエンドを通るためMCP 経由でも再現する可能性がある。