[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-elastic--mcp-server-elasticsearch":3,"tool-elastic--mcp-server-elasticsearch":65},[4,18,32,41,49,57],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85092,2,"2026-04-10T11:13:16",[15,16,27,28,13,29,30,14,31],"视频","插件","其他","语言模型","音频",{"id":33,"name":34,"github_repo":35,"description_zh":36,"stars":37,"difficulty_score":38,"last_commit_at":39,"category_tags":40,"status":17},5784,"funNLP","fighting41love\u002FfunNLP","funNLP 是一个专为中文自然语言处理（NLP）打造的超级资源库，被誉为\"NLP 民工的乐园”。它并非单一的软件工具，而是一个汇集了海量开源项目、数据集、预训练模型和实用代码的综合性平台。\n\n面对中文 NLP 领域资源分散、入门门槛高以及特定场景数据匮乏的痛点，funNLP 提供了“一站式”解决方案。这里不仅涵盖了分词、命名实体识别、情感分析、文本摘要等基础任务的标准工具，还独特地收录了丰富的垂直领域资源，如法律、医疗、金融行业的专用词库与数据集，甚至包含古诗词生成、歌词创作等趣味应用。其核心亮点在于极高的全面性与实用性，从基础的字典词典到前沿的 BERT、GPT-2 模型代码，再到高质量的标注数据和竞赛方案，应有尽有。\n\n无论是刚刚踏入 NLP 领域的学生、需要快速验证想法的算法工程师，还是从事人工智能研究的学者，都能在这里找到急需的“武器弹药”。对于开发者而言，它能大幅减少寻找数据和复现模型的时间；对于研究者，它提供了丰富的基准测试资源和前沿技术参考。funNLP 以开放共享的精神，极大地降低了中文自然语言处理的开发与研究成本，是中文 AI 社区不可或缺的宝藏仓库。",79857,1,"2026-04-08T20:11:31",[30,16,29],{"id":42,"name":43,"github_repo":44,"description_zh":45,"stars":46,"difficulty_score":38,"last_commit_at":47,"category_tags":48,"status":17},5773,"cs-video-courses","Developer-Y\u002Fcs-video-courses","cs-video-courses 是一个精心整理的计算机科学视频课程清单，旨在为自学者提供系统化的学习路径。它汇集了全球知名高校（如加州大学伯克利分校、新南威尔士大学等）的完整课程录像，涵盖从编程基础、数据结构与算法，到操作系统、分布式系统、数据库等核心领域，并深入延伸至人工智能、机器学习、量子计算及区块链等前沿方向。\n\n面对网络上零散且质量参差不齐的教学资源，cs-video-courses 解决了学习者难以找到成体系、高难度大学级别课程的痛点。该项目严格筛选内容，仅收录真正的大学层级课程，排除了碎片化的简短教程或商业广告，确保用户能接触到严谨的学术内容。\n\n这份清单特别适合希望夯实计算机基础的开发者、需要补充特定领域知识的研究人员，以及渴望像在校生一样系统学习计算机科学的自学者。其独特的技术亮点在于分类极其详尽，不仅包含传统的软件工程与网络安全，还细分了生成式 AI、大语言模型、计算生物学等新兴学科，并直接链接至官方视频播放列表，让用户能一站式获取高质量的教育资源，免费享受世界顶尖大学的课堂体验。",79792,"2026-04-08T22:03:59",[29,15,16,14],{"id":50,"name":51,"github_repo":52,"description_zh":53,"stars":54,"difficulty_score":38,"last_commit_at":55,"category_tags":56,"status":17},2234,"scikit-learn","scikit-learn\u002Fscikit-learn","scikit-learn 是一个基于 Python 构建的开源机器学习库，依托于 SciPy、NumPy 等科学计算生态，旨在让机器学习变得简单高效。它提供了一套统一且简洁的接口，涵盖了从数据预处理、特征工程到模型训练、评估及选择的全流程工具，内置了包括线性回归、支持向量机、随机森林、聚类等在内的丰富经典算法。\n\n对于希望快速验证想法或构建原型的数据科学家、研究人员以及 Python 开发者而言，scikit-learn 是不可或缺的基础设施。它有效解决了机器学习入门门槛高、算法实现复杂以及不同模型间调用方式不统一的痛点，让用户无需重复造轮子，只需几行代码即可调用成熟的算法解决分类、回归、聚类等实际问题。\n\n其核心技术亮点在于高度一致的 API 设计风格，所有估算器（Estimator）均遵循相同的调用逻辑，极大地降低了学习成本并提升了代码的可读性与可维护性。此外，它还提供了强大的模型选择与评估工具，如交叉验证和网格搜索，帮助用户系统地优化模型性能。作为一个由全球志愿者共同维护的成熟项目，scikit-learn 以其稳定性、详尽的文档和活跃的社区支持，成为连接理论学习与工业级应用的最",65751,"2026-04-10T08:35:09",[14,29,16],{"id":58,"name":59,"github_repo":60,"description_zh":61,"stars":62,"difficulty_score":24,"last_commit_at":63,"category_tags":64,"status":17},3364,"keras","keras-team\u002Fkeras","Keras 是一个专为人类设计的深度学习框架，旨在让构建和训练神经网络变得简单直观。它解决了开发者在不同深度学习后端之间切换困难、模型开发效率低以及难以兼顾调试便捷性与运行性能的痛点。\n\n无论是刚入门的学生、专注算法的研究人员，还是需要快速落地产品的工程师，都能通过 Keras 轻松上手。它支持计算机视觉、自然语言处理、音频分析及时间序列预测等多种任务。\n\nKeras 3 的核心亮点在于其独特的“多后端”架构。用户只需编写一套代码，即可灵活选择 TensorFlow、JAX、PyTorch 或 OpenVINO 作为底层运行引擎。这一特性不仅保留了 Keras 一贯的高层易用性，还允许开发者根据需求自由选择：利用 JAX 或 PyTorch 的即时执行模式进行高效调试，或切换至速度最快的后端以获得最高 350% 的性能提升。此外，Keras 具备强大的扩展能力，能无缝从本地笔记本电脑扩展至大规模 GPU 或 TPU 集群，是连接原型开发与生产部署的理想桥梁。",63927,"2026-04-04T15:24:37",[14,16,29],{"id":66,"github_repo":67,"name":68,"description_en":69,"description_zh":70,"ai_summary_zh":71,"readme_en":72,"readme_zh":73,"quickstart_zh":74,"use_case_zh":75,"hero_image_url":76,"owner_login":77,"owner_name":77,"owner_avatar_url":78,"owner_bio":79,"owner_company":69,"owner_location":69,"owner_email":80,"owner_twitter":69,"owner_website":81,"owner_url":82,"languages":83,"stars":100,"forks":101,"last_commit_at":102,"license":103,"difficulty_score":10,"env_os":104,"env_gpu":105,"env_ram":105,"env_deps":106,"category_tags":110,"github_topics":111,"view_count":24,"oss_zip_url":69,"oss_zip_packed_at":69,"status":17,"created_at":116,"updated_at":117,"faqs":118,"releases":119},6251,"elastic\u002Fmcp-server-elasticsearch","mcp-server-elasticsearch",null,"mcp-server-elasticsearch 是一款基于模型上下文协议（MCP）的开源连接器，旨在让 AI 智能体能够直接通过自然语言与 Elasticsearch 数据进行交互。它解决了传统模式下需要编写定制化 API 或复杂查询代码才能检索和分析数据的痛点，使智能体无需额外开发即可执行查询、分析及数据提取任务。\n\n该工具主要面向开发者、数据工程师以及正在构建 AI 应用的研究人员。如果你希望在 Claude Desktop、Cursor 或 VS Code 等环境中，让 AI 助手直接理解并操作你的搜索索引，mcp-server-elasticsearch 提供了便捷的桥梁。其技术亮点在于支持 stdio 和 streamable-HTTP 两种通信协议，既能满足本地客户端的直接调用，也能适应基于 Web 的集成场景；同时，它以 Docker 容器形式交付，简化了部署流程，并兼容 API 密钥等多种认证方式。\n\n需要注意的是，官方已标记此项目为“弃用”状态，未来仅保留关键安全更新，建议新用户关注 Elastic 9.2.0+ 版本中推出的新一代 Elastic Agent Bu","mcp-server-elasticsearch 是一款基于模型上下文协议（MCP）的开源连接器，旨在让 AI 智能体能够直接通过自然语言与 Elasticsearch 数据进行交互。它解决了传统模式下需要编写定制化 API 或复杂查询代码才能检索和分析数据的痛点，使智能体无需额外开发即可执行查询、分析及数据提取任务。\n\n该工具主要面向开发者、数据工程师以及正在构建 AI 应用的研究人员。如果你希望在 Claude Desktop、Cursor 或 VS Code 等环境中，让 AI 助手直接理解并操作你的搜索索引，mcp-server-elasticsearch 提供了便捷的桥梁。其技术亮点在于支持 stdio 和 streamable-HTTP 两种通信协议，既能满足本地客户端的直接调用，也能适应基于 Web 的集成场景；同时，它以 Docker 容器形式交付，简化了部署流程，并兼容 API 密钥等多种认证方式。\n\n需要注意的是，官方已标记此项目为“弃用”状态，未来仅保留关键安全更新，建议新用户关注 Elastic 9.2.0+ 版本中推出的新一代 Elastic Agent Builder MCP 端点以获得更长期的支持。尽管如此，对于现有 8.x 或 9.x 集群的快速集成验证，它依然是一个高效实用的选择。","# Elasticsearch MCP Server\n\n> [!CAUTION]\n> This MCP server is deprecated and will only receive critical security updates going forward.\n> It has been superseded by the [Elastic Agent Builder](https:\u002F\u002Fela.st\u002Fagent-builder-docs) [MCP endpoint](https:\u002F\u002Fela.st\u002Fagent-builder-mcp), which is available in Elastic 9.2.0+ and Elasticsearch Serverless projects.\n\n## Use the Elasticsearch MCP Server for AI Agents\n\nThe Elasticsearch MCP Server connects your AI agents to Elasticsearch data using the [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io\u002Fdocs\u002Fgetting-started\u002Fintro) (MCP).\nIt enables natural language interactions with your Elasticsearch indices, allowing agents to query, analyze, and retrieve data without custom APIs.\n\nFollow these steps to deploy and configure the Elasticsearch MCP Server container image from AWS Marketplace.\n\n### Before you begin\n\nBefore you start, ensure you have:\n\n- An Elasticsearch cluster (version 8.x or 9.x) accessible from your AWS environment\n- Elasticsearch authentication credentials:\n  - An [API key](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fdeploy-manage\u002Fapi-keys), or\n  - A [username](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fdeploy-manage\u002Fusers-roles) and password pair\n- Docker installed and running in your AWS environment (for example, on an EC2 instance or in a container service)\n- An MCP client configured (such as Claude Desktop, Cursor, VS Code, or another MCP-compatible tool)\n- Network connectivity between your deployment environment and your Elasticsearch cluster\n\n> [!NOTE]\n>\n> These instructions apply to Elasticsearch MCP Server 0.4.0 and later.\n> For versions 0.3.1 and earlier, refer to the [README for v0.3.1](https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Ftree\u002Fv0.3.1).\n\n### Deploy the Elasticsearch MCP Server\n\nThe Elasticsearch MCP Server is provided as a Docker container image available from AWS Marketplace. You can run it using either the stdio protocol (for direct client connections) or the streamable-HTTP protocol (for web-based integrations).\n\n#### Choose a protocol\n\nThe server supports two protocols:\n\n- [stdio](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002Flatest\u002Fbasic\u002Ftransports#stdio): Direct communication between the MCP client and server. Use this when your client supports stdio and runs in the same environment.\n- [streamable-HTTP](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002Flatest\u002Fbasic\u002Ftransports#streamable-http): HTTP-based protocol recommended for web integrations, stateful sessions, and concurrent clients.\n\n> **Note:** Server-Sent Events (SSE) is deprecated. Use streamable-HTTP instead.\n\n### Configure the stdio protocol\n\nUse the stdio protocol when your MCP client connects directly to the server process.\n\n#### Set environment variables for stdio mode\n\nSet the following environment variables:\n\n- `ES_URL`: The URL of your Elasticsearch cluster (for example, `https:\u002F\u002Fyour-cluster.es.amazonaws.com:9200`)\n- For authentication, use one of these options:\n  - API key: Set `ES_API_KEY` to your Elasticsearch API key\n  - Basic authentication: Set `ES_USERNAME` and `ES_PASSWORD` to your Elasticsearch credentials\n- (Optional) `ES_SSL_SKIP_VERIFY`: Set to `true` to skip SSL\u002FTLS certificate verification when connecting to Elasticsearch. Only use this for development or testing environments.\n\n#### Run the container in stdio mode\n\nStart the MCP server in stdio mode:\n\n```bash\ndocker run -i --rm \\\n  -e ES_URL \\\n  -e ES_API_KEY \\\n  docker.elastic.co\u002Fmcp\u002Felasticsearch \\\n  stdio\n```\n\n#### Configure Claude Desktop\n\nAdd this configuration to your Claude Desktop configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"elasticsearch-mcp-server\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-e\", \"ES_URL\",\n        \"-e\", \"ES_API_KEY\",\n        \"docker.elastic.co\u002Fmcp\u002Felasticsearch\",\n        \"stdio\"\n      ],\n      \"env\": {\n        \"ES_URL\": \"\u003Celasticsearch-cluster-url>\",\n        \"ES_API_KEY\": \"\u003Celasticsearch-API-key>\"\n      }\n    }\n  }\n}\n```\n\nReplace `\u003Celasticsearch-cluster-url>` with your Elasticsearch cluster URL and `\u003Celasticsearch-API-key>` with your API key.\n\n### Configure the streamable-HTTP protocol\n\nUse the streamable-HTTP protocol for web-based integrations or when you need to support multiple concurrent clients.\n\n#### Set environment variables for HTTP mode\n\nSet the same environment variables as the stdio protocol:\n\n- `ES_URL`: The URL of your Elasticsearch cluster\n- For authentication, use one of these options:\n  - API key: Set `ES_API_KEY` to your Elasticsearch API key\n  - Basic authentication: Set `ES_USERNAME` and `ES_PASSWORD` to your Elasticsearch credentials\n- (Optional) `ES_SSL_SKIP_VERIFY`: Set to `true` to skip SSL\u002FTLS certificate verification\n\n#### Run the container in HTTP mode\n\nStart the MCP server in HTTP mode:\n\n```bash\ndocker run --rm \\\n  -e ES_URL \\\n  -e ES_API_KEY \\\n  -p 8080:8080 \\\n  docker.elastic.co\u002Fmcp\u002Felasticsearch \\\n  http\n```\n\nThe streamable-HTTP endpoint is available at `http:\u002F\u002F\u003Chost>:8080\u002Fmcp`. A health check endpoint is available at `http:\u002F\u002F\u003Chost>:8080\u002Fping`.\n\n#### Configure Claude Desktop with HTTP proxy\n\nIf you're using Claude Desktop (free edition) which only supports the stdio protocol, use `mcp-proxy` to bridge stdio to streamable-HTTP:\n\n1. Install `mcp-proxy`:\n\n   ```bash\n   uv tool install mcp-proxy\n   ```\n   For alternative installation options, refer to [mcp-proxy\u002FREADME.md](https:\u002F\u002Fgithub.com\u002Fsparfenyuk\u002Fmcp-proxy\u002Fblob\u002Fmain\u002FREADME.md).\n\n2. Add this configuration to Claude Desktop:\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"elasticsearch-mcp-server\": {\n         \"command\": \"\u002F\u003Chome-directory>\u002F.local\u002Fbin\u002Fmcp-proxy\",\n         \"args\": [\n           \"--transport=streamablehttp\",\n           \"--header\", \"Authorization\", \"ApiKey \u003Celasticsearch-API-key>\",\n           \"http:\u002F\u002F\u003Cmcp-server-host>:\u003Cmcp-server-port>\u002Fmcp\"\n         ]\n       }\n     }\n   }\n   ```\n\n   Replace `\u003Chome-directory>`, `\u003Celasticsearch-API-key>`, `\u003Cmcp-server-host>`, and `\u003Cmcp-server-port>` with your values.\n\n### Verify the connection\n\nAfter configuring your MCP client, verify the connection works:\n\n1. Start your MCP client (for example, Claude Desktop or Cursor).\n2. Check that the Elasticsearch MCP Server appears in your available MCP servers.\n3. Test a simple query through your agent interface to confirm it can access your Elasticsearch indices.\n\nIf the connection fails, verify:\n\n- Your Elasticsearch cluster URL is correct and accessible from your AWS environment\n- Your authentication credentials are valid and have the necessary permissions\n- Network connectivity exists between the container and your Elasticsearch cluster (check security groups and network ACLs)\n- Docker is running and the container started successfully (check container logs with `docker logs \u003Ccontainer-id>`)\n\n### Monitor health and status\n\nMonitor the health and proper function of the Elasticsearch MCP Server using these methods:\n\n#### Check container status\n\nVerify the container is running:\n\n```bash\ndocker ps | grep elasticsearch-mcp-server\n```\n\nThe container should appear in the list with a status of `Up`.\n\n#### Test the health endpoint (HTTP mode)\n\nIf you're using the streamable-HTTP protocol, test the health check endpoint:\n\n```bash\ncurl http:\u002F\u002F\u003Chost>:8080\u002Fping\n```\n\nA successful response returns `pong`, indicating the server is running and healthy.\n\n#### Check container logs\n\nView container logs to identify any issues:\n\n```bash\ndocker logs \u003Ccontainer-id>\n```\n\nLook for error messages related to:\n\n- Elasticsearch connection failures\n- Authentication errors\n- Network connectivity issues\n\n#### Verify Elasticsearch connectivity\n\nTest connectivity to your Elasticsearch cluster from the container:\n\n```bash\ndocker exec \u003Ccontainer-id> curl -k -u \u003Cusername>:\u003Cpassword> \u003CES_URL>\n```\n\nOr with an API key:\n\n```bash\ndocker exec \u003Ccontainer-id> curl -k -H \"Authorization: ApiKey \u003Capi-key>\" \u003CES_URL>\n```\n\nA successful response indicates the container can reach your Elasticsearch cluster.\n\n### Security and sensitive information\n\nThe Elasticsearch MCP Server handles authentication credentials securely:\n\n#### Credential storage\n\n- **API keys and passwords**: Stored only in environment variables passed to the container. They are not persisted to disk or logged.\n- **Environment variables**: Set when you run the container. Use AWS Secrets Manager or AWS Systems Manager Parameter Store to manage credentials securely in production environments.\n\n#### Data encryption\n\n- **In transit**: The MCP server communicates with Elasticsearch over HTTPS when your `ES_URL` uses the `https:\u002F\u002F` protocol. Ensure your Elasticsearch cluster has SSL\u002FTLS enabled.\n- **At rest**: The container does not store data locally. All data remains in your Elasticsearch cluster, which uses your cluster's encryption settings.\n\n#### Best practices\n\n- Rotate API keys regularly (every 30-90 days for production environments)\n- Use API keys with minimal required permissions (read-only access to specific indices when possible)\n- Never commit credentials to version control or share them in logs\n- Use AWS Secrets Manager or Parameter Store to inject credentials at runtime instead of hardcoding them\n\n### AWS service quotas\n\nThe Elasticsearch MCP Server runs as a container in your AWS environment. Consider these AWS service quotas:\n\n- **EC2 instance limits**: If running on EC2, ensure your instance type supports your expected workload\n- **Elastic Container Service (ECS)**: If using ECS, review [ECS service quotas](https:\u002F\u002Fdocs.aws.amazon.com\u002FAmazonECS\u002Flatest\u002Fdeveloperguide\u002Fservice-quotas.html)\n- **Elastic Kubernetes Service (EKS)**: If using EKS, review [EKS service quotas](https:\u002F\u002Fdocs.aws.amazon.com\u002Feks\u002Flatest\u002Fuserguide\u002Fservice-quotas.html)\n- **Network bandwidth**: Ensure sufficient network bandwidth between your container and Elasticsearch cluster\n\nTo request quota increases, use the [AWS Service Quotas console](https:\u002F\u002Fconsole.aws.amazon.com\u002Fservicequotas\u002F) or refer to the [AWS General Reference Guide](https:\u002F\u002Fdocs.aws.amazon.com\u002Fgeneral\u002Flatest\u002Fgr\u002Faws_service_limits.html).\n\n### Available tools\n\nOnce connected, the MCP server provides these tools to your agent:\n\n- `list_indices`: List all available Elasticsearch indices\n- `get_mappings`: Get field mappings for a specific Elasticsearch index\n- `search`: Perform an Elasticsearch search using query DSL\n- `esql`: Execute an ES|QL query\n- `get_shards`: Get shard information for all or specific indices\n\nYour agent can use these tools to interact with your Elasticsearch data through natural language conversations.\n\n### Next steps\n\n- Learn about AI-powered features available in the Elastic platform\n- Explore Agent Builder for building custom AI agents with Elasticsearch\n","# Elasticsearch MCP 服务器\n\n> [!CAUTION]\n> 此 MCP 服务器已弃用，今后仅会接收关键安全更新。\n> 它已被 [Elastic Agent Builder](https:\u002F\u002Fela.st\u002Fagent-builder-docs) 的 [MCP 端点](https:\u002F\u002Fela.st\u002Fagent-builder-mcp) 取代，该端点在 Elastic 9.2.0+ 和 Elasticsearch Serverless 项目中可用。\n\n## 使用 Elasticsearch MCP 服务器为 AI 代理提供支持\n\nElasticsearch MCP 服务器通过 [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io\u002Fdocs\u002Fgetting-started\u002Fintro) (MCP) 将您的 AI 代理与 Elasticsearch 数据连接起来。\n它使您能够以自然语言与 Elasticsearch 索引进行交互，允许代理在无需自定义 API 的情况下查询、分析和检索数据。\n\n请按照以下步骤从 AWS Marketplace 部署并配置 Elasticsearch MCP 服务器容器镜像。\n\n### 开始之前\n\n在开始之前，请确保您具备以下条件：\n\n- 一个可从您的 AWS 环境访问的 Elasticsearch 集群（版本 8.x 或 9.x）\n- Elasticsearch 身份验证凭据：\n  - [API 密钥](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fdeploy-manage\u002Fapi-keys)，或\n  - [用户名](https:\u002F\u002Fwww.elastic.co\u002Fdocs\u002Fdeploy-manage\u002Fusers-roles) 和密码对\n- 在您的 AWS 环境中已安装并运行 Docker（例如，在 EC2 实例上或容器服务中）\n- 已配置好一个 MCP 客户端（如 Claude Desktop、Cursor、VS Code 或其他兼容 MCP 的工具）\n- 您的部署环境与 Elasticsearch 集群之间具有网络连通性\n\n> [!NOTE]\n>\n> 本说明适用于 Elasticsearch MCP 服务器 0.4.0 及更高版本。\n> 对于 0.3.1 及更早版本，请参阅 [v0.3.1 的 README](https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Ftree\u002Fv0.3.1)。\n\n### 部署 Elasticsearch MCP 服务器\n\nElasticsearch MCP 服务器以 Docker 容器镜像的形式提供，可在 AWS Marketplace 中获取。您可以使用 stdio 协议（用于直接客户端连接）或 streamable-HTTP 协议（用于基于 Web 的集成）来运行它。\n\n#### 选择协议\n\n该服务器支持两种协议：\n\n- [stdio](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002Flatest\u002Fbasic\u002Ftransports#stdio)：MCP 客户端与服务器之间的直接通信。当您的客户端支持 stdio 并在同一环境中运行时，请使用此协议。\n- [streamable-HTTP](https:\u002F\u002Fmodelcontextprotocol.io\u002Fspecification\u002Flatest\u002Fbasic\u002Ftransports#streamable-http)：基于 HTTP 的协议，推荐用于 Web 集成、有状态会话以及并发客户端。\n\n> **注意：** 服务器发送事件 (SSE) 已弃用。请改用 streamable-HTTP。\n\n### 配置 stdio 协议\n\n当您的 MCP 客户端直接连接到服务器进程时，请使用 stdio 协议。\n\n#### 设置 stdio 模式的环境变量\n\n设置以下环境变量：\n\n- `ES_URL`：您的 Elasticsearch 集群的 URL（例如，`https:\u002F\u002Fyour-cluster.es.amazonaws.com:9200`）\n- 对于身份验证，使用以下选项之一：\n  - API 密钥：将 `ES_API_KEY` 设置为您 Elasticsearch 的 API 密钥\n  - 基本身份验证：将 `ES_USERNAME` 和 `ES_PASSWORD` 设置为您的 Elasticsearch 凭据\n- （可选）`ES_SSL_SKIP_VERIFY`：设置为 `true` 以在连接到 Elasticsearch 时跳过 SSL\u002FTLS 证书验证。仅在开发或测试环境中使用此选项。\n\n#### 以 stdio 模式运行容器\n\n以 stdio 模式启动 MCP 服务器：\n\n```bash\ndocker run -i --rm \\\n  -e ES_URL \\\n  -e ES_API_KEY \\\n  docker.elastic.co\u002Fmcp\u002Felasticsearch \\\n  stdio\n```\n\n#### 配置 Claude Desktop\n\n将此配置添加到您的 Claude Desktop 配置文件中：\n\n```json\n{\n  \"mcpServers\": {\n    \"elasticsearch-mcp-server\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-e\", \"ES_URL\",\n        \"-e\", \"ES_API_KEY\",\n        \"docker.elastic.co\u002Fmcp\u002Felasticsearch\",\n        \"stdio\"\n      ],\n      \"env\": {\n        \"ES_URL\": \"\u003Celasticsearch-cluster-url>\",\n        \"ES_API_KEY\": \"\u003Celasticsearch-API-key>\"\n      }\n    }\n  }\n}\n```\n\n将 `\u003Celasticsearch-cluster-url>` 替换为您的 Elasticsearch 集群 URL，将 `\u003Celasticsearch-API-key>` 替换为您的 API 密钥。\n\n### 配置 streamable-HTTP 协议\n\n当您需要进行基于 Web 的集成，或需要支持多个并发客户端时，请使用 streamable-HTTP 协议。\n\n#### 设置 HTTP 模式的环境变量\n\n设置与 stdio 协议相同的环境变量：\n\n- `ES_URL`：您的 Elasticsearch 集群的 URL\n- 对于身份验证，使用以下选项之一：\n  - API 密钥：将 `ES_API_KEY` 设置为您 Elasticsearch 的 API 密钥\n  - 基本身份验证：将 `ES_USERNAME` 和 `ES_PASSWORD` 设置为您的 Elasticsearch 凭据\n- （可选）`ES_SSL_SKIP_VERIFY`：设置为 `true` 以在连接时跳过 SSL\u002FTLS 证书验证。\n\n#### 以 HTTP 模式运行容器\n\n以 HTTP 模式启动 MCP 服务器：\n\n```bash\ndocker run --rm \\\n  -e ES_URL \\\n  -e ES_API_KEY \\\n  -p 8080:8080 \\\n  docker.elastic.co\u002Fmcp\u002Felasticsearch \\\n  http\n```\n\nstreamable-HTTP 端点位于 `http:\u002F\u002F\u003Chost>:8080\u002Fmcp`。健康检查端点位于 `http:\u002F\u002F\u003Chost>:8080\u002Fping`。\n\n#### 使用 HTTP 代理配置 Claude Desktop\n\n如果您使用的是仅支持 stdio 协议的 Claude Desktop（免费版），可以使用 `mcp-proxy` 将 stdio 桥接到 streamable-HTTP：\n\n1. 安装 `mcp-proxy`：\n\n   ```bash\n   uv tool install mcp-proxy\n   ```\n   如需其他安装选项，请参阅 [mcp-proxy\u002FREADME.md](https:\u002F\u002Fgithub.com\u002Fsparfenyuk\u002Fmcp-proxy\u002Fblob\u002Fmain\u002FREADME.md)。\n\n2. 将以下配置添加到 Claude Desktop：\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"elasticsearch-mcp-server\": {\n         \"command\": \"\u002F\u003Chome-directory>\u002F.local\u002Fbin\u002Fmcp-proxy\",\n         \"args\": [\n           \"--transport=streamablehttp\",\n           \"--header\", \"Authorization\", \"ApiKey \u003Celasticsearch-API-key>\",\n           \"http:\u002F\u002F\u003Cmcp-server-host>:\u003Cmcp-server-port>\u002Fmcp\"\n         ]\n       }\n     }\n   }\n   ```\n\n   将 `\u003Chome-directory>`、`\u003Celasticsearch-API-key>`、`\u003Cmcp-server-host>` 和 `\u003Cmcp-server-port>` 替换为您自己的值。\n\n### 验证连接\n\n配置好您的 MCP 客户端后，请验证连接是否正常工作：\n\n1. 启动您的 MCP 客户端（例如，Claude Desktop 或 Cursor）。\n2. 检查 Elasticsearch MCP 服务器是否出现在可用的 MCP 服务器列表中。\n3. 通过您的代理界面测试一个简单的查询，以确认它可以访问您的 Elasticsearch 索引。\n\n如果连接失败，请检查：\n\n- 您的 Elasticsearch 集群 URL 是否正确，并且可以从您的 AWS 环境访问\n- 您的身份验证凭据是否有效，并具有必要的权限\n- 容器与 Elasticsearch 集群之间是否存在网络连通性（检查安全组和网络 ACL）\n- Docker 是否正在运行，容器是否成功启动（使用 `docker logs \u003Ccontainer-id>` 查看容器日志）\n\n### 监控健康与状态\n\n使用以下方法监控 Elasticsearch MCP 服务器的健康状况和正常运行：\n\n#### 检查容器状态\n\n验证容器是否正在运行：\n\n```bash\ndocker ps | grep elasticsearch-mcp-server\n```\n\n容器应出现在列表中，状态为 `Up`。\n\n#### 测试健康端点（HTTP 模式）\n\n如果您使用的是可流式传输的 HTTP 协议，请测试健康检查端点：\n\n```bash\ncurl http:\u002F\u002F\u003Chost>:8080\u002Fping\n```\n\n成功的响应会返回 `pong`，表明服务器正在运行且健康。\n\n#### 查看容器日志\n\n查看容器日志以识别任何问题：\n\n```bash\ndocker logs \u003Ccontainer-id>\n```\n\n查找与以下内容相关的错误消息：\n\n- Elasticsearch 连接失败\n- 身份验证错误\n- 网络连接问题\n\n#### 验证 Elasticsearch 连接\n\n从容器内测试与您的 Elasticsearch 集群的连接：\n\n```bash\ndocker exec \u003Ccontainer-id> curl -k -u \u003Cusername>:\u003Cpassword> \u003CES_URL>\n```\n\n或者使用 API 密钥：\n\n```bash\ndocker exec \u003Ccontainer-id> curl -k -H \"Authorization: ApiKey \u003Capi-key>\" \u003CES_URL>\n```\n\n成功的响应表示容器可以访问您的 Elasticsearch 集群。\n\n### 安全与敏感信息\n\nElasticsearch MCP 服务器会安全地处理身份验证凭据：\n\n#### 凭据存储\n\n- **API 密钥和密码**：仅存储在传递给容器的环境变量中。它们不会持久化到磁盘或记录到日志中。\n- **环境变量**：在运行容器时设置。在生产环境中，请使用 AWS Secrets Manager 或 AWS Systems Manager Parameter Store 来安全管理凭据。\n\n#### 数据加密\n\n- **传输中**：当您的 `ES_URL` 使用 `https:\u002F\u002F` 协议时，MCP 服务器会通过 HTTPS 与 Elasticsearch 通信。请确保您的 Elasticsearch 集群已启用 SSL\u002FTLS。\n- **静态数据**：容器不会在本地存储数据。所有数据都保留在您的 Elasticsearch 集群中，使用集群的加密设置。\n\n#### 最佳实践\n\n- 定期轮换 API 密钥（生产环境每 30–90 天一次）\n- 使用具有最小必要权限的 API 密钥（尽可能只授予对特定索引的只读访问权限）\n- 切勿将凭据提交到版本控制系统或在日志中共享\n- 使用 AWS Secrets Manager 或 Parameter Store 在运行时注入凭据，而不是将其硬编码。\n\n### AWS 服务配额\n\nElasticsearch MCP 服务器作为容器在您的 AWS 环境中运行。请考虑以下 AWS 服务配额：\n\n- **EC2 实例限制**：如果在 EC2 上运行，请确保您的实例类型能够支持预期的工作负载。\n- **Elastic Container Service (ECS)**：如果使用 ECS，请查看 [ECS 服务配额](https:\u002F\u002Fdocs.aws.amazon.com\u002FAmazonECS\u002Flatest\u002Fdeveloperguide\u002Fservice-quotas.html)。\n- **Elastic Kubernetes Service (EKS)**：如果使用 EKS，请查看 [EKS 服务配额](https:\u002F\u002Fdocs.aws.amazon.com\u002Feks\u002Flatest\u002Fuserguide\u002Fservice-quotas.html)。\n- **网络带宽**：确保容器与 Elasticsearch 集群之间的网络带宽充足。\n\n如需申请提高配额，请使用 [AWS 服务配额控制台](https:\u002F\u002Fconsole.aws.amazon.com\u002Fservicequotas\u002F) 或参考 [AWS 通用参考指南](https:\u002F\u002Fdocs.aws.amazon.com\u002Fgeneral\u002Flatest\u002Fgr\u002Faws_service_limits.html)。\n\n### 可用工具\n\n连接成功后，MCP 服务器会向您的代理提供以下工具：\n\n- `list_indices`：列出所有可用的 Elasticsearch 索引\n- `get_mappings`：获取特定 Elasticsearch 索引的字段映射\n- `search`：使用查询 DSL 执行 Elasticsearch 搜索\n- `esql`：执行 ES|QL 查询\n- `get_shards`：获取所有或特定索引的分片信息\n\n您的代理可以使用这些工具，通过自然语言对话与您的 Elasticsearch 数据进行交互。\n\n### 后续步骤\n\n- 了解 Elastic 平台中可用的人工智能功能\n- 探索 Agent Builder，使用 Elasticsearch 构建自定义 AI 代理","# mcp-server-elasticsearch 快速上手指南\n\n> **⚠️ 重要提示**：该 MCP 服务器已标记为**弃用（Deprecated）**，未来仅接收关键安全更新。官方推荐使用 Elastic 9.2.0+ 或 Elasticsearch Serverless 项目中的 **[Elastic Agent Builder](https:\u002F\u002Fela.st\u002Fagent-builder-docs)** 替代。以下指南仅适用于仍需使用此版本的场景。\n\n## 环境准备\n\n在开始之前，请确保满足以下条件：\n\n*   **Elasticsearch 集群**：版本 8.x 或 9.x，且可从您的部署环境（如 AWS EC2、本地 Docker）访问。\n*   **认证凭据**：具备以下任一组合：\n    *   Elasticsearch **API Key**（推荐）\n    *   **用户名**和**密码**\n*   **Docker 环境**：已安装并运行 Docker。\n*   **MCP 客户端**：已配置支持 MCP 的工具（如 Claude Desktop、Cursor、VS Code 等）。\n*   **网络连通性**：确保运行容器的环境与 Elasticsearch 集群之间网络通畅。\n\n## 安装与配置步骤\n\n该工具以 Docker 容器形式提供，支持 `stdio`（直接连接）和 `streamable-HTTP`（Web 集成）两种协议。\n\n### 方案 A：使用 stdio 协议（推荐用于本地客户端）\n\n适用于 MCP 客户端与服务器在同一环境直接通信的场景（如 Claude Desktop 本地版）。\n\n1.  **设置环境变量**\n    在终端中导出以下变量（替换为您的实际值）：\n    ```bash\n    export ES_URL=\"https:\u002F\u002Fyour-cluster.es.amazonaws.com:9200\"\n    export ES_API_KEY=\"your_elasticsearch_api_key\"\n    # 若使用账号密码认证，则使用以下两行代替 ES_API_KEY\n    # export ES_USERNAME=\"your_username\"\n    # export ES_PASSWORD=\"your_password\"\n    \n    # 开发测试环境下若需跳过 SSL 验证（生产环境请勿使用）\n    # export ES_SSL_SKIP_VERIFY=\"true\"\n    ```\n\n2.  **运行容器**\n    执行以下命令启动服务：\n    ```bash\n    docker run -i --rm \\\n      -e ES_URL \\\n      -e ES_API_KEY \\\n      docker.elastic.co\u002Fmcp\u002Felasticsearch \\\n      stdio\n    ```\n\n3.  **配置 MCP 客户端（以 Claude Desktop 为例）**\n    编辑 Claude Desktop 配置文件，添加如下内容：\n    ```json\n    {\n      \"mcpServers\": {\n        \"elasticsearch-mcp-server\": {\n          \"command\": \"docker\",\n          \"args\": [\n            \"run\", \"-i\", \"--rm\",\n            \"-e\", \"ES_URL\",\n            \"-e\", \"ES_API_KEY\",\n            \"docker.elastic.co\u002Fmcp\u002Felasticsearch\",\n            \"stdio\"\n          ],\n          \"env\": {\n            \"ES_URL\": \"\u003Celasticsearch-cluster-url>\",\n            \"ES_API_KEY\": \"\u003Celasticsearch-API-key>\"\n          }\n        }\n      }\n    }\n    ```\n    *请将 `\u003Celasticsearch-cluster-url>` 和 `\u003Celasticsearch-API-key>` 替换为您的实际地址和密钥。*\n\n---\n\n### 方案 B：使用 streamable-HTTP 协议（推荐用于 Web 集成或多客户端）\n\n适用于需要独立服务进程或通过 HTTP 暴露接口的场景。\n\n1.  **设置环境变量**\n    同方案 A，设置 `ES_URL` 和认证信息。\n\n2.  **运行容器**\n    启动 HTTP 模式服务（默认端口 8080）：\n    ```bash\n    docker run --rm \\\n      -e ES_URL \\\n      -e ES_API_KEY \\\n      -p 8080:8080 \\\n      docker.elastic.co\u002Fmcp\u002Felasticsearch \\\n      http\n    ```\n    服务地址：`http:\u002F\u002F\u003Chost>:8080\u002Fmcp`\n    健康检查地址：`http:\u002F\u002F\u003Chost>:8080\u002Fping`\n\n3.  **配置 MCP 客户端（通过代理连接）**\n    若客户端仅支持 stdio（如 Claude Desktop 免费版），需使用 `mcp-proxy` 桥接：\n    \n    *   安装代理工具：\n        ```bash\n        uv tool install mcp-proxy\n        ```\n    *   修改客户端配置：\n        ```json\n        {\n          \"mcpServers\": {\n            \"elasticsearch-mcp-server\": {\n              \"command\": \"\u002F\u003Chome-directory>\u002F.local\u002Fbin\u002Fmcp-proxy\",\n              \"args\": [\n                \"--transport=streamablehttp\",\n                \"--header\", \"Authorization\", \"ApiKey \u003Celasticsearch-API-key>\",\n                \"http:\u002F\u002F\u003Cmcp-server-host>:8080\u002Fmcp\"\n              ]\n            }\n          }\n        }\n        ```\n\n## 基本使用\n\n配置完成后，重启您的 MCP 客户端（如 Claude Desktop 或 Cursor）。\n\n1.  **验证连接**\n    在客户端中确认 `elasticsearch-mcp-server` 已出现在可用服务器列表中。\n\n2.  **自然语言交互示例**\n    直接在对话框中输入自然语言指令，AI Agent 将自动调用底层工具操作 Elasticsearch。\n\n    *   **查询索引列表**：\n        > \"列出所有的 Elasticsearch 索引。\"\n        *(对应工具：`list_indices`)*\n\n    *   **执行搜索**：\n        > \"搜索 'logs-' 开头的索引中，状态码为 500 的错误日志。\"\n        *(对应工具：`search`)*\n\n    *   **执行 ES|QL 查询**：\n        > \"使用 ES|QL 统计过去一小时每个用户的请求数量。\"\n        *(对应工具：`esql`)*\n\n    *   **查看映射结构**：\n        > \"显示 'products' 索引的字段映射结构。\"\n        *(对应工具：`get_mappings`)*\n\n### 可用工具列表\nAgent 可直接调用的核心功能包括：\n*   `list_indices`: 列出所有索引\n*   `get_mappings`: 获取指定索引的字段映射\n*   `search`: 执行 DSL 搜索查询\n*   `esql`: 执行 ES|QL 查询\n*   `get_shards`: 获取分片信息","某电商公司的数据分析师需要快速排查近期订单系统的异常波动，并生成简要分析报告。\n\n### 没有 mcp-server-elasticsearch 时\n- 分析师必须手动编写复杂的 Elasticsearch DSL 查询语句，稍有语法错误就会导致查询失败，排查耗时极长。\n- 每次切换分析维度（如从“地区”切换到“商品类别”）都需要重新修改代码并运行脚本，无法进行流畅的探索式分析。\n- 非技术背景的产品经理想要了解具体数据时，分析师需中断工作专门为其提取数据，沟通与交付成本高昂。\n- 难以将自然语言问题（如“上周哪个地区的退货率最高？”）直接转化为可执行的查询逻辑，依赖人工翻译需求。\n\n### 使用 mcp-server-elasticsearch 后\n- 分析师直接在 Claude Desktop 或 Cursor 中用自然语言提问，mcp-server-elasticsearch 自动将其转换为精准的 DSL 查询并返回结果。\n- 支持多轮对话式分析，只需追加指令（如“再按支付渠道细分”），mcp-server-elasticsearch 即可即时调整查询逻辑并更新数据视图。\n- 产品经理可直接通过配置的 MCP 客户端自行询问数据细节，mcp-server-elasticsearch 充当了安全的中间层，无需分析师反复介入。\n- 实现了从“人脑翻译需求”到\"AI 自动执行”的转变，mcp-server-elasticsearch 让团队能专注于数据洞察而非查询语法调试。\n\nmcp-server-elasticsearch 的核心价值在于打破了自然语言与数据库查询之间的壁垒，让团队成员能以对话方式实时挖掘 Elasticsearch 中的数据金矿。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Felastic_mcp-server-elasticsearch_c2c174b6.png","elastic","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Felastic_f440e060.png","","info@elastic.co","https:\u002F\u002Fwww.elastic.co\u002F","https:\u002F\u002Fgithub.com\u002Felastic",[84,88,92,96],{"name":85,"color":86,"percentage":87},"Rust","#dea584",94.3,{"name":89,"color":90,"percentage":91},"Makefile","#427819",2.7,{"name":93,"color":94,"percentage":95},"Dockerfile","#384d54",1.6,{"name":97,"color":98,"percentage":99},"Shell","#89e051",1.4,642,135,"2026-04-09T21:14:58","Apache-2.0","Linux, macOS, Windows","未说明",{"notes":107,"python":105,"dependencies":108},"该工具已弃用，仅接收关键安全更新，建议迁移至 Elastic Agent Builder。运行环境必须安装 Docker。需要可访问的 Elasticsearch 集群（8.x 或 9.x 版本）。支持通过 stdio 或 streamable-HTTP 协议运行。凭证需通过环境变量传递，生产环境建议使用 AWS Secrets Manager 管理。",[109],"Docker",[16],[112,113,114,115],"elasticsearch","mcp","mcp-server","vector-database","2026-03-27T02:49:30.150509","2026-04-10T20:47:16.313848",[],[120,125,130,135,140,145,150,155,160,165,170,175],{"id":121,"version":122,"summary_zh":123,"released_at":124},189186,"v0.4.6","添加弃用通知\n","2025-10-24T18:00:05",{"id":126,"version":127,"summary_zh":128,"released_at":129},189187,"v0.4.5","## 修复\r\n\r\n* 由 @mimol91 在 https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F158 中更新了用于用户名的 ENV 名称\r\n\r\n## 新贡献者\r\n\r\n* @mimol91 在 https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F158 中完成了首次贡献\r\n\r\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcompare\u002Fv0.4.4...v0.4.5","2025-07-18T16:25:43",{"id":131,"version":132,"summary_zh":133,"released_at":134},189188,"v0.4.4","## 修复\n\n* 由 @swallez 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F145> 中添加 CA 证书\n\n**完整更新日志**: \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcompare\u002Fv0.4.3...v0.4.4>\n\n","2025-07-15T16:44:14",{"id":136,"version":137,"summary_zh":138,"released_at":139},189189,"v0.4.3","## 修复\n\n* 由 @swallez 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F144> 中将默认端口改回 8080\n\n**完整更新日志**: \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcompare\u002Fv0.4.2...v0.4.3>\n\n","2025-07-15T16:43:30",{"id":141,"version":142,"summary_zh":143,"released_at":144},189190,"v0.4.2","## 修复\n\n* 将默认端口更改为 8000，由 @JoshMock 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F142> 中完成\n\n**完整更新日志**: \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcompare\u002Fv0.3.1...v0.4.2>\n\n","2025-07-15T16:42:31",{"id":146,"version":147,"summary_zh":148,"released_at":149},189191,"v0.4.1","## 修复事项\n\n- 在 Dockerfile 中添加 `EXPOSE` 指令以暴露端口 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcommit\u002F0cc4d1fe2771f5677347aa595aefdb00f0de1a40>\n- 添加 `CLI_ARGS` 环境变量，作为直接向二进制文件或 `docker run` 命令传递参数的替代方案 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcommit\u002F336f4635760fe8fbd0d8201a78a3215f842bd864>\n- 在 `\u002F` HTTP 路径中添加“hello”消息 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcommit\u002F0cc4d1fe2771f5677347aa595aefdb00f0de1a40>\n- 处理空 URL 的情况 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcommit\u002F383786090bda4abb69ce304cb0a98611d33a0e59>\n- 在 Elasticsearch 请求中添加 `User-Agent` HTTP 头 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcommit\u002Fc89f8b461eb44f8a0473bb517946d7dfcd6d5473>\n\n**完整变更日志**: \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcompare\u002Fv0.4.0...v0.4.1>","2025-07-10T19:22:23",{"id":151,"version":152,"summary_zh":153,"released_at":154},189192,"v0.4.0","* 基于 [MCP Rust SDK](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Frust-sdk) 的全新架构\n* 添加对流式 HTTP 和 SSE 的支持\n* 新增 ES|QL 工具\n* 为搜索工具添加 `field` 参数，以便大语言模型更容易获得更精准的响应（例如，Gemini Flash 2.0 能理解查询 DSL，但不熟悉用于过滤文档属性的 `_source` 属性）\n* 现在推荐使用 Docker 进行安装，并针对 stdio 和 http 协议提供了文档说明，其中包括 Claude Desktop 的安装指南。\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcompare\u002Fv0.3.1...v0.4.0","2025-07-04T13:44:34",{"id":156,"version":157,"summary_zh":158,"released_at":159},189193,"v0.3.1","## 修复\n\n* `npx -y @elastic\u002Fmcp-server-elasticsearch` 因缺少 shebang 而失败，由 @JoshMock 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F122> 中修复。\n\n**完整变更日志**： \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcompare\u002Fv0.3.0...v0.3.1>\n\n","2025-07-01T20:08:29",{"id":161,"version":162,"summary_zh":163,"released_at":164},189194,"v0.3.0","## 功能特性\n\n* 由 @calclavia 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F31> 中实现的 Smithery 配置\n* 由 @anuraaga 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F64> 中实现的 OpenTelemetry 支持\n* 由 @sternbergm 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F46> 中实现的向搜索工具添加聚合结果功能\n* 由 @getsolaris 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F28> 中实现的向搜索工具添加 profile 和 explain 功能\n* 由 @slhck 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F77> 中实现的添加跳过 SSL 验证选项的功能\n\n## 修复内容\n\n* 由 @JoshMock 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F91> 中实现的正确验证 `caCert` 值\n* 由 @swallez 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F97> 中实现的修复 Docker 安装并要求使用 'stdio' CLI 参数\n* 由 @atline 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F106> 中实现的修复默认用户值问题\n* 各种依赖项更新\n\n## 新贡献者\n\n* @calclavia 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F31> 中完成了首次贡献\n* @anuraaga 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F64> 中完成了首次贡献\n* @sternbergm 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F46> 中完成了首次贡献\n* @slhck 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F77> 中完成了首次贡献\n* @swallez 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F97> 中完成了首次贡献\n* @atline 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F106> 中完成了首次贡献\n\n**完整变更日志**: \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcompare\u002Fv0.2.0...v0.3.0>","2025-06-30T21:04:39",{"id":166,"version":167,"summary_zh":168,"released_at":169},189195,"v0.2.0","## 新特性\n\n* 添加 `get_shards` 工具，用于监控分片状态，由 @getsolaris 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F25> 中实现。\n* 使身份验证校验更加灵活，由 @getsolaris 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F27> 中实现。\n* 为列出索引工具添加索引模式参数，由 @susan-shu-c 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F44> 中实现。\n* 添加 Elasticsearch 路径前缀的新配置选项，由 @bryangwj 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F72> 中实现。\n* 包含 MCP 的特定 `user-agent`，由 @technige 和 @JoshMock 分别在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F68> 和 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F81> 中实现。\n* 添加 Dockerfile，由 @JoshMock 分别在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F80> 和 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F82> 中实现。\n* 允许使用 Elasticsearch 8.x 版本的服务器，由 @nathanhuglo 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F71> 中实现。\n\n## 新贡献者\n\n* @getsolaris 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F25> 中完成了首次贡献。\n* @nayrttam 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F55> 中完成了首次贡献。\n* @susan-shu-c 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F44> 中完成了首次贡献。\n* @bryangwj 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F72> 中完成了首次贡献。\n* @technige 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F68> 中完成了首次贡献。\n* @JoshMock 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F79> 中完成了首次贡献。\n* @nathanhuglo 在 \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F71> 中完成了首次贡献。\n\n**完整变更日志**: \u003Chttps:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcompare\u002Fv0.1.1...v0.2.0>\n\n","2025-06-10T18:01:38",{"id":171,"version":172,"summary_zh":173,"released_at":174},189196,"v0.1.1","## What's Changed\r\n* chore: Configure Renovate by @elastic-renovate-prod in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F3\r\n* Create LICENSE by @jedrazb in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F8\r\n* chore(deps): pin dependencies by @elastic-renovate-prod in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F4\r\n* chore(deps): update node.js to v22.14.0 by @elastic-renovate-prod in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F9\r\n* fix(deps): update dependency @modelcontextprotocol\u002Fsdk to v1.8.0 by @elastic-renovate-prod in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F10\r\n* chore(deps): update dependency shx to v0.4.0 by @elastic-renovate-prod in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F5\r\n* ci: add minimal tests by @jedrazb in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F12\r\n* Bootstrap repository by @elastic-backstage-prod in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F14\r\n* docs: Improve README by @jedrazb in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F11\r\n* chore(deps): update dependency @types\u002Fnode to v22.13.14 by @elastic-renovate-prod in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F13\r\n* docs: add badge by @jedrazb in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F16\r\n* feat: support username\u002Fpass auth + self-signed ca cert by @jedrazb in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F20\r\n* chore(deps): update dependency @types\u002Fnode to v22.13.15 by @elastic-renovate-prod in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F22\r\n* chore: run renovate on monday morning by @jedrazb in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F23\r\n\r\n## New Contributors\r\n* @elastic-renovate-prod made their first contribution in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F3\r\n* @elastic-backstage-prod made their first contribution in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F14\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcompare\u002Fv0.1.0...v0.1.1","2025-04-03T07:37:41",{"id":176,"version":177,"summary_zh":178,"released_at":179},189197,"v0.1.0","## What's Changed\r\n* Add NPM publish config  by @jedrazb in https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fpull\u002F2\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Felastic\u002Fmcp-server-elasticsearch\u002Fcommits\u002Fv0.1.0","2025-04-03T07:37:18"]