Elasticsearch/OpenSearch MCP 服务器

概述

一个实现模型上下文协议（MCP）的服务器，提供与Elasticsearch和OpenSearch交互的功能。此服务器通过一系列工具支持搜索文档、分析索引以及管理集群。

演示

https://github.com/user-attachments/assets/f7409e31-fac4-4321-9c9c

功能

索引操作

• list_indices: 列出集群中的所有索引。
• create_index: 创建一个新的索引。
• delete_index: 删除指定的索引。
• update_mapping: 更新索引的映射关系。

文档操作

• search_docs: 搜索指定索引中的文档。
• get_doc: 获取指定索引和ID的文档。
• index_doc: 向指定索引添加或更新文档。
• delete_doc: 删除指定索引和ID的文档。

集群操作

• cluster_health: 查看集群的健康状态。
• cluster_stats: 获取集群的统计信息。
• nodes_info: 列出集群中的所有节点及其信息。
• nodes_stats: 获取各个节点的详细统计信息。

别名操作

• list_aliases: 列出指定索引的所有别名。
• create_alias: 创建一个新的别名。
• delete_alias: 删除指定的别名。
• update_alias: 更新现有别名的配置。

配置环境变量

# Elasticsearch 配置
ELASTICSEARCH_HOSTS=http://localhost:9200
ELASTICSEARCH_USERNAME=
ELASTICSEARCH_PASSWORD=

# OpenSearch 配置（如果需要）
OPENSEARCH_HOSTS=http://localhost:9200
OPENSEARCH_USERNAME=
OPENSEARCH_PASSWORD=

启动 Elasticsearch/OpenSearch 集群

使用 Docker 启动

# 启动 Elasticsearch
docker run -d --name elasticsearch -p 9200:9200 -p 9300:9300 docker.elastic.co/elasticsearch/elasticsearch:7.17.2

# 启动 OpenSearch
docker run -d --name opensearch -p 9200:9200 -p 9300:9300 amazon/opensearch:1.5.0

在 Claude Desktop 中使用

安装方法

方法一：通过 uv 命令安装

# Elasticsearch 版本
uv run mcp_client/client.py src/server.py --elasticsearch

# OpenSearch 版本
uv run mcp_client/client.py src/server.py --opensearch

许可证

此项目在 Apache License Version 2.0 下开源，具体信息请参阅 LICENSE 文件。