Unread MCP Server

Unread MCP 服务

一个只读的模型上下文协议（MCP）服务，用于搜索 Unread RSS 阅读器数据库。此服务可按关键词搜索存储在 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 应用