Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
# Elasticsearch MCP Server
[![smithery badge](https://smithery.ai/badge/@elastic/mcp-server-elasticsearch)](https://smithery.ai/server/@elastic/mcp-server-elasticsearch)

This repository contains experimental features intended for research and evaluation and are not production-ready.

Expand Down Expand Up @@ -29,6 +30,14 @@ https://github.com/user-attachments/assets/5dd292e1-a728-4ca7-8f01-1380d1bebe0c

## Installation & Setup

### Installing via Smithery

To install Elasticsearch MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@elastic/mcp-server-elasticsearch):

```bash
npx -y @smithery/cli install @elastic/mcp-server-elasticsearch --client claude
```

### Using the Published NPM Package

> [!TIP]
Expand Down
41 changes: 41 additions & 0 deletions smithery.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Smithery configuration file: https://smithery.ai/docs/config#smitheryyaml

startCommand:
type: stdio
configSchema:
# JSON Schema defining the configuration options for the MCP.
type: object
required:
- esUrl
properties:
esUrl:
type: string
description: Elasticsearch instance URL
esApiKey:
type: string
description: Elasticsearch API key for authentication (optional if using
username/password)
esUsername:
type: string
description: Elasticsearch username for basic authentication (optional)
esPassword:
type: string
description: Elasticsearch password for basic authentication (optional)
esCaCert:
type: string
description: Path to a custom CA certificate if needed (optional)
commandFunction:
# A JS function that produces the CLI command based on the given config to start the MCP on stdio.
|-
(config) => ({
command: 'node',
args: ['dist/index.js'],
env: Object.assign({
ES_URL: config.esUrl
}, config.esApiKey ? { ES_API_KEY: config.esApiKey } : {},
config.esUsername && config.esPassword ? { ES_USERNAME: config.esUsername, ES_PASSWORD: config.esPassword } : {},
config.esCaCert ? { ES_CA_CERT: config.esCaCert } : {})
})
exampleConfig:
esUrl: http://localhost:9200
esApiKey: your-elasticsearch-api-key