Elasticsearch 7.x MCP 服务器

一个用于 Elasticsearch 7.x 的 MCP 服务器，提供与 Elasticsearch 7.x 版本的兼容性。

特性

• 提供用于与 Elasticsearch 7.x 交互的 MCP 协议接口
• 支持基本的 Elasticsearch 操作（ping, info 等）
• 支持完整的搜索功能，包括聚合查询、高亮显示、排序和其他高级功能
• 通过任何 MCP 客户端轻松访问 Elasticsearch 功能

要求

• Python 3.10+
• Elasticsearch 7.x (推荐 7.17.x)

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Elasticsearch 7.x MCP 服务器：

npx -y @smithery/cli install @imlewc/elasticsearch7-mcp-server --client claude

手动安装

pip install -e .

环境变量

服务器需要以下环境变量：

• ELASTIC_HOST: Elasticsearch 主机地址 (例如，http://localhost:9200)
• ELASTIC_USERNAME: Elasticsearch 用户名
• ELASTIC_PASSWORD: Elasticsearch 密码
• MCP_PORT: (可选) MCP 服务器监听端口，默认为 9999

使用 Docker Compose

1. 创建一个 .env 文件并设置 ELASTIC_PASSWORD:

ELASTIC_PASSWORD=your_secure_password

2. 启动服务：

docker-compose up -d

这将启动一个包含三个节点的 Elasticsearch 7.17.10 集群、Kibana 和 MCP 服务器。

使用 MCP 客户端

您可以使用任何 MCP 客户端连接到 MCP 服务器：

from mcp import MCPClient

client = MCPClient("localhost:9999")
response = client.call("es-ping")
print(response)  # {"success": true}

API 文档

当前支持的 MCP 方法：

• es-ping: 检查 Elasticsearch 连接
• es-info: 获取 Elasticsearch 集群信息
• es-search: 在 Elasticsearch 索引中搜索文档

搜索 API 示例

基本搜索

# 基本搜索
search_response = client.call("es-search", {
    "index": "my_index",
    "query": {
        "match": {
            "title": "search keywords"
        }
    },
    "size": 10,
    "from": 0
})

聚合查询

# 聚合查询
agg_response = client.call("es-search", {
    "index": "my_index",
    "size": 0,  # 只需要聚合结果，不需要文档
    "aggs": {
        "categories": {
            "terms": {
                "field": "category.keyword",
                "size": 10
            }
        },
        "avg_price": {
            "avg": {
                "field": "price"
            }
        }
    }
})

高级搜索

# 带有高亮显示、排序和过滤的高级搜索
advanced_response = client.call("es-search", {
    "index": "my_index",
    "query": {
        "bool": {
            "must": [
                {"match": {"content": "search term"}}
            ],
            "filter": [
                {"range": {"price": {"gte": 100, "lte": 200}}}
            ]
        }
    },
    "sort": [
        {"date": {"order": "desc"}},
        "_score"
    ],
    "highlight": {
        "fields": {
            "content": {}
        }
    },
    "_source": ["title", "date", "price"]
})

开发

1. 克隆存储库
2. 安装开发依赖项
3. 运行服务器: elasticsearch7-mcp-server

许可证

[许可证位于 LICENSE 文件中]

中文文档