Elasticsearch MCP服务器

一个基于Spring Boot的应用,将Elasticsearch操作作为MCP工具暴露,允许AI助手直接与产品数据交互。

  • by vatsal259
  • Java
  • 云端部署
  • 更新于
在 GitHub 查看 vatsal259/elasticsearch-mcp

使用说明

Elasticsearch MCP服务器

一个Spring Boot应用程序,它将Elasticsearch操作公开为 MCP(模型上下文协议) 工具,允许AI助手直接与您的产品数据交互。

🚀 特性

  • MCP集成:人工智能助手的原生工具(Claude等)。
  • 搜索:全文搜索、类别/品牌过滤、价格范围。
  • 管理:产品目录的CRUD操作。
  • 灵活的身份验证:支持API密钥、基本身份验证或无身份验证。

📋 先决条件

  • Java 21+
  • Maven 3.6+
  • Elasticsearch 8.x/9.x(推荐使用Docker)

🖥️ 运行服务器

启动MCP服务器(确保Elasticsearch正在运行并在中配置 application.yml):

./mvnw spring-boot:run

服务器正在监听 端口8080 并在以下位置暴露MCP端点 /mcp (可流式传输HTTP)。

🔌 在HTTP上的游标中使用此MCP

此服务器使用 可流式传输HTTP 传输,因此Cursor通过URL连接到它,而不是启动进程。

  1. 启动服务器 (见上文)。使用HTTP时,游标不会为您启动它。

  2. 配置光标 使用HTTP端点。

    选项A–项目配置(推荐)
    此回购包括 .cursor/mcp.json:

    {
      "mcpServers": {
        "elasticsearch-mcp": {
          "url": "http://localhost:8080/mcp",
          "type": "streamableHttp"
        }
      }
    }
    

    选项B–全局配置
    添加相同内容 elasticsearch-mcp 进入 ~/.cursor/mcp.json 在...之下 mcpServers.

  3. 重新加载光标 (或重新启动),以便它获取MCP配置。

  4. 检查MCP状态 在 光标设置→ MCP。服务器必须在以下位置运行 http://localhost:8080 以便连接成功。

如果MCP显示错误,请确保Spring Boot应用程序正在运行,并且没有其他任何东西在使用端口8080。