Recoll MCP Server

重新计费MCP服务器

通过Claude Desktop与Recoll索引文件系统的自然语言接口。

概述

此MCP（模型上下文协议）服务器允许Claude AI访问您的Recoll搜索索引，从而能够对整个索引文件系统进行自然语言查询。

特性

• 自然语言搜索：让克劳德用简单的英语查找文件
• 高级过滤：按日期范围、文件类型等搜索
• 内容访问：检索完整文档内容
• 最近的文件：列出最近修改的文件
• 快：通过Recoll Python API直接访问Xapian索引

需求

• Python 3.10+
• Recoll（使用Python绑定）
• 克劳德桌面版
• MCP Python SDK

安装

1. 安装依赖项：

pip install mcp
# Recoll Python bindings are usually included with recoll package

1. 配置Claude桌面：

编辑 ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "recoll-search": {
      "command": "python3",
      "args": [
        "/home/sam/src/recoll-mcp-server/recoll_mcp_server.py"
      ],
      "env": {
        "RECOLL_CONFDIR": "/home/sam/.config/recoll"
      }
    }
  }
}

1. 重新启动克劳德桌面

使用示例

配置后，您可以询问Claude：

• “查找我12月份关于YubiKey的笔记”
• “搜索包含‘机器学习’的PDF”
• “显示我本周修改的文件”
• “查找有关Nextcloud的标记文件”

可用工具

搜索文件系统

使用带有布尔运算符（AND、or、NOT）的关键字或短语进行搜索。

搜索_日期

按修改日期范围筛选结果。

search_by_filetype

按文件类型/mimetype（pdf、markdown、文本等）过滤。

get_document_content

检索特定文档的完整内容。

list_recent_files

在索引中列出最近修改的文件。

发展

直接测试重新充气API：

python test_recoll_api.py

建筑

User (natural language)
    ↓
Claude Desktop (with MCP)
    ↓
Recoll MCP Server (Python)
    ↓
Recoll Python API
    ↓
Xapian Index (your filesystem)

许可证

Apache 2.0