Lucene MCP 服务器

“Lucene” MCP 服务器的作用是什么？

MCP Lucene 服务器是一款基于 Java 的模型上下文协议（MCP）实现，采用 Apache Lucene 提供高效的搜索与检索能力。作为符合 MCP 标准的服务器，它允许 AI 助手和代理与大型文档库交互，完成全文搜索、索引和元数据过滤等任务。通过其 RESTful API，Lucene MCP 服务器允许客户端使用 Lucene 强大的查询语法进行文档的 upsert（新增/更新）、删除、列出和查询。基于 Spring Boot 构建，易于部署，并可通过 Docker 容器化。此服务器非常适合将高级文档搜索和管理能力集成到 AI 驱动的工作流或软件开发流程中。

Prompt 列表

仓库中未提供有关 prompt 模板的信息。

资源列表

仓库中未描述显式的 MCP 资源。

工具列表

• Upsert 工具

  • 允许客户端通过 /mcp/v1/upsert 接口向 Lucene 索引新增或更新文档。

• Delete 工具

  • 允许通过 /mcp/v1/delete 接口从 Lucene 索引中删除文档。

• List 工具

  • 通过 /mcp/v1/list 接口获取索引中的文档列表。

• Query 工具

  • 使用 /mcp/v1/query 接口，支持基于 Lucene 查询语法的复杂搜索。

• Status 工具

  • 通过 /mcp/v1/status 接口检查服务器状态。

该 MCP 服务器的应用场景举例

• 企业文档搜索
  开发者可集成 Lucene MCP 服务器，为大规模业务文档提供强大而可扩展的搜索能力，便于查找相关文件和记录。

• 知识库增强
  让 AI 助手能够检索并获取索引化的公司手册、FAQ 或支持工单中的信息。

• 自动化数据采集与索引
  通过编程方式向 Lucene 索引 upsert 和更新文档，确保搜索引擎始终保持最新。

• 基于元数据的过滤
  利用 Lucene 的能力，根据文档元数据过滤查询，支持高级数据检索场景。

• API 驱动的搜索集成
  通过 RESTful 接口，为其他应用或代理无缝提供文档搜索和管理功能。

如何部署

Windsurf

1. 确保已安装 Java 11+ 和 Maven 3.6+。
2. 构建项目：

   mvn clean install
   

3. 将 MCP Lucene 服务器添加到您的配置中：

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. 保存您的配置并启动 Windsurf。
5. 在 http://localhost:8080/mcp/v1/status 验证服务器是否运行。

Claude

1. 安装 Java 11+ 和 Maven 3.6+。
2. 构建项目：

   mvn clean install
   

3. 编辑您的 Claude 配置，添加如下内容：

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. 重启 Claude 并确保 MCP Lucene 服务器可访问。

Cursor

1. 确认已安装 Java 11+ 和 Maven 3.6+。
2. 构建 Lucene MCP 服务器：

   mvn clean install
   

3. 添加到您的 Cursor 配置中：

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. 保存并重启 Cursor。
5. 在 http://localhost:8080/mcp/v1/status 测试端点。

Cline

1. 确保已安装 Java 11+ 和 Maven 3.6+。
2. 构建：

   mvn clean install
   

3. 在您的 Cline 配置中：

   {
     "mcpServers": {
       "lucene-mcp": {
         "command": "java",
         "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"]
       }
     }
   }
   

4. 重启 Cline 并确认 MCP 服务器已启动。

关于 API 密钥安全的说明

如果您的配置需要保护 API 密钥或敏感信息，请使用环境变量：

{
  "mcpServers": {
    "lucene-mcp": {
      "command": "java",
      "args": ["-jar", "target/mcp-lucene-server-0.0.1-SNAPSHOT.jar"],
      "env": {
        "LUCENE_API_KEY": "${LUCENE_API_KEY}"
      },
      "inputs": {
        "apiKey": "${LUCENE_API_KEY}"
      }
    }
  }
}

如何在流程中使用 MCP

在 FlowHunt 中使用 MCP

要在 FlowHunt 工作流中集成 MCP 服务器，请先将 MCP 组件添加到流程中，并与您的 AI agent 连接：

点击 MCP 组件打开配置面板。在系统 MCP 配置部分，使用如下 JSON 格式填写您的 MCP 服务器信息：

{
  "lucene-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI agent 即可作为工具使用此 MCP，并拥有其所有功能和能力。请记得将 “lucene-mcp” 替换为您的实际 MCP 服务器名称，并将 URL 替换为您自己的 MCP 服务器地址。

概览

根据当前信息，MCP Lucene 服务器在文档搜索和管理方面提供了坚实的基础，但缺乏 prompt 模板、资源、roots 或采样等高级 MCP 支持。其安装和使用文档较为完善，适合作为 MCP 服务器集成。

我们的看法

MCP Lucene 服务器是一款强大且实用的企业级搜索与文档管理 MCP 实现。不过，缺乏 prompt 模板、资源定义以及 roots 或采样等高级 MCP 特性，限制了其在更复杂 agentic 工作流中的灵活性。总体而言，它是将 Lucene 搜索集成到 AI 系统中的坚实起点。MCP 评分：6/10

MCP 评分