Unread MCP Server

Unread MCP サーバー

Unread RSS リーダーのデータベースを検索する、読み取り専用の Model Context Protocol（MCP）サーバーです。このサーバーは、Unread アプリに保存された記事をキーワードベースで全文検索できます。

機能

• キーワードベースの全文検索 — セマンティック検索／ベクトル検索ではありません
• 記事のタイトル、本文、著者、フィード名を横断して検索
• 記事のステータス（スター付き、既読、未読）で絞り込み
• 特定のフィード内を検索
• データベースの統計情報
• ブール演算子（AND、OR、NOT）
• 引用符を使った完全一致フレーズ検索

インストール

1. Unread アプリがインストールされており、データベースに記事があることを確認します
2. このディレクトリを ~/Developer/unread-mcp/ にクローンまたはコピーします
3. スクリプトを実行可能にします：

   chmod +x ~/Developer/unread-mcp/unread-mcp.sh
   

設定

Claude Desktop の設定ファイルに次の内容を追加します：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "unread-search": {
      "command": "/Users/YOUR_USERNAME/Developer/unread-mcp/unread-mcp.sh"
    }
  }
}

YOUR_USERNAME を実際のユーザー名に置き換えてください。

使い方

設定が完了すると、Claude で次のツールを使用できます：

search-articles

キーワードを使ってすべての記事を検索します：

• 単純なキーワード：bicycle、javascript
• ブール演算子：AI OR artificial intelligence、python NOT django
• 完全一致フレーズ："climate change"
• * または空のクエリを指定すると、最近読んだ記事が表示されます
• ステータスで絞り込み：スター付き、既読、未読
• 簡単なプレビュー（約300文字）と記事 ID を返します

get-article

特定の記事の全文を取得します：

• 検索結果に表示された記事 ID を使用します
• メタデータ付きで記事全文を返します

get-stats

記事の総数、未読数、スター付き記事数など、データベースの統計情報を取得します

list-feeds

すべての RSS フィードを記事数とともに一覧表示します

search-by-feed

特定のフィード内の記事を検索します

• 簡単なプレビューと記事 ID を返します

例

• 「スター付きの記事から AI または artificial intelligence を検索して」
• 「サイクリングに関する未読記事を探して」
• 「javascript に関する記事を表示して。ただし react は除いて」
• 「記事から 'climate change' を検索して」
• 「フィードを記事数順に一覧表示して」
• 「The Radavist フィードから自転車の記事を検索して」

重要事項

• これは読み取り専用のサーバーであり、データベースを変更できません
• 検索はキーワードベースであり、セマンティック検索ではありません。具体的な語句を使用してください
• データベースのパスは Unread のデフォルトの場所に固定されています
• sqlite3 と jq がインストールされている必要があります（macOS には標準で付属しています）

トラブルシューティング

デバッグ情報については、スクリプトと同じディレクトリにある requests.log ファイルを確認してください。

依存関係

• bash
• sqlite3
• jq
• データベースに記事がある Unread アプリ