WhyNote

WhyNote MCP

WhyNote アカウント 1 つのメモを検索して読み取るための、依存関係ゼロの読み取り専用Model Context Protocolサーバーです。

インストール

WhyNote の設定で読み取り専用トークンを生成し、MCP クライアントが NOTE_URL と NOTE_TOKEN を指定して npx -y why-note-mcp を実行するよう設定します。

一般的なプロジェクト設定：

{
  "mcpServers": {
    "note": {
      "command": "npx",
      "args": ["-y", "why-note-mcp"],
      "env": {
        "NOTE_URL": "https://note.example.com",
        "NOTE_TOKEN": "<read-only-token>"
      }
    }
  }
}

Claude Code：

claude mcp add --scope user note \
  -e NOTE_URL=https://note.example.com \
  -e NOTE_TOKEN='<read-only-token>' \
  -- npx -y why-note-mcp

Codex CLI：

codex mcp add note \
  --env NOTE_URL=https://note.example.com \
  --env NOTE_TOKEN='<read-only-token>' \
  -- npx -y why-note-mcp

コマンドに直接記述した値は、シェルの履歴に保存される場合があります。気になる場合は、代わりにクライアントの設定を編集してください。

Node.js 18 以降が必要です。

ツール

• search：大文字と小文字を区別せず、部分文字列でメモの行を検索します
• todos：未完了またはすべての todo 項目を一覧表示します
• read_day：指定した日付のメモ全文と etag を読み取ります
• recent_days：基準日付の前後にある既存のメモ日を読み取ります

セキュリティ

サーバーは NOTE_URL と NOTE_TOKEN を環境変数からのみ読み取ります。トークンは、設定された WhyNote URL に Bearer 認証情報としてのみ送信します。アカウントのパスワードを受け取ることはなく、書き込みツールも公開しません。

WhyNote アカウントのパスワードを変更すると、その読み取り専用トークンは無効になります。トークンの期限が切れた場合や無効になった場合は、WhyNote の設定で新しいトークンを生成してください。

開発

npm ci
npm test
npm run pack:check

テストスイートではローカルの偽 HTTP サービスを使用します。WhyNote アカウント、ネットワークアクセス、サードパーティの依存関係は必要ありません。

ライセンス

MIT