{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zz7e86aqhbzh","handle":"es-mcp-server","url":"https://wellknown.network/agents/es-mcp-server","links":{"self":"https://wellknown.network/agents/es-mcp-server/record.json","html":"https://wellknown.network/agents/es-mcp-server","markdown":"https://wellknown.network/agents/es-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/es-mcp-server","status":"https://wellknown.network/api/v1/agents/es-mcp-server/status","claim":"https://wellknown.network/agents/es-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/es-mcp-server/claim.json","badge":"https://wellknown.network/agents/es-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/es-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/es-mcp-server/tools"},"ard":{"identifier":"urn:air::server:es-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"es-mcp-server","summary":"Elasticsearch MCP 服务器和客户端","description":"# Elasticsearch MCP 服务器\n\n基于 [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol/python-sdk) 的 Elasticsearch 工具服务器，提供索引查询、映射获取、搜索等功能。\n\n其他语言版本: [🇺🇸 English](./README.en.md) | [🇫🇷 Français](./README.fr.md) | [🇩🇪 Deutsch](./README.de.md) | [🇯🇵 日本語](./README.jp.md)\n\n## 项目目录结构\n\n```\n.\n├── es_mcp_server/         # 服务器代码\n│   ├── __init__.py        # 包初始化\n│   ├── server.py          # 服务器主程序\n│   ├── config.py          # 配置管理\n│   ├── client.py          # ES客户端工厂\n│   └── tools.py           # ES MCP工具实现\n├── es_mcp_client/         # 客户端代码\n│   ├── __init__.py        # 包初始化\n│   └── client.py          # 客户端测试程序\n├── test/                  # 单元测试\n│   ├── __init__.py        # 测试包初始化\n│   └── test_server.py     # 服务器单元测试\n├── claude_config_examples/ # Claude配置示例\n│   ├── elasticsearch_stdio_config.json # stdio模式配置\n│   └── elasticsearch_sse_config.json   # sse模式配置\n├── .vscode/               # VSCode配置\n│   └── launch.json        # 调试配置\n├── docs/                  # 文档\n│   └── requires.md        # 需求文档\n├── pyproject.toml         # 项目配置文件\n├── README.md              # 中文说明文档\n├── README.en.md           # 英文说明文档\n├── README.fr.md           # 法语说明文档\n├── README.de.md           # 德语说明文档\n├── README.jp.md           # 日语说明文档\n├── .gitignore             # Git忽略文件\n└── LICENSE                # MIT许可证\n```\n\n## 服务器功能和使用说明\n\nElasticsearch MCP 服务器提供以下工具：\n\n1. **list_indices** - 显示 ES 集群的所有索引\n2. **get_mappings** - 返回指定索引的字段映射信息\n3. **search** - 在指定索引中执行搜索查询，支持高亮显示\n4. **get_cluster_health** - 获取 ES 集群的健康状态信息\n5. **get_cluster_stats** - 获取 ES 集群的运行状态统计信息\n\n### 安装\n\n```bash\n# 从PyPI安装\npip install es-mcp-server\n\n# 或从源码安装\npip install .\n\n# 安装开发依赖\npip install \".[dev]\"\n```\n\n### 配置 \n\n服务器通过环境变量或命令行参数进行配置：\n\n| 环境变量 | 说明 | 默认值 |\n|----------|------|--------|\n| ES_HOST | ES 主机地址 | localhost |\n| ES_PORT | ES 端口 | 9200 |\n| ES_USERNAME | ES 用户名 | 无 |\n| ES_PASSWORD | ES 密码 | 无 |\n| ES_API_KEY | ES API 密钥 | 无 |\n| ES_USE_SSL | 是否使用 SSL | false |\n| ES_VERIFY_CERTS | 是否验证证书 | true |\n| ES_VERSION | ES 版本 (7 或 8) | 8 |\n…","publisher":{"name":"Claude-3.7-Sonnet","url":null},"homepage":null,"repository":null,"version":"0.1.4","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:es-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"es"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"es-mcp-server","registry":"pypi","observedAt":"2026-09-15T14:26:54.928Z","publishedAt":"2025-06-03T07:26:49.826767Z","latestVersion":"0.1.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"es-mcp-server","url":"https://pypi.org/project/es-mcp-server/","firstSeenAt":"2026-09-09T15:21:44.775Z","fetchedAt":"2026-09-15T14:24:52.117Z","normalizedAt":"2026-09-15T14:24:52.117Z"}]},"firstSeenAt":"2026-09-09T15:21:44.775Z","updatedAt":"2026-09-15T14:26:54.928Z"}