MCP Server for OpenSearch

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides a semantic memory layer on top of OpenSearch database, allowing storage and retrieval of memories using the Model Context Protocol. Supports storing memories and searching through them with prepared JSON queries.

mcp-server-opensearch: Un servidor MCP de OpenSearch

El Protocolo de Contexto de Modelo (MCP) es un protocolo abierto que permite una integración fluida entre las aplicaciones LLM y las fuentes de datos y herramientas externas. Ya sea que esté creando un IDE basado en IA, mejorando una interfaz de chat o creando flujos de trabajo de IA personalizados, MCP proporciona una forma estandarizada de conectar las aplicaciones LLM con el contexto que necesitan.

Este repositorio es un ejemplo de cómo crear un servidor MCP para OpenSearch , un motor de búsqueda y análisis distribuido.

En construcción

Bloqueador actual: el cliente asincrónico de OpenSearch no se instala

Documentos del cliente asincrónico de búsqueda abierta

pip install opensearch-py[async] zsh: no matches found: opensearch-py[async]

Descripción general

Un servidor básico del Protocolo de Contexto de Modelo para almacenar y recuperar memorias en el motor de búsqueda OpenSearch. Actúa como una capa de memoria semántica sobre la base de datos de OpenSearch.

Componentes

Herramientas

  1. search-openSearch
    • Almacenar una memoria en la base de datos de OpenSearch
    • Aporte:
      • query (json): mensaje de consulta json preparado
    • Devoluciones: Mensaje de confirmación

Instalación

Instalación mediante herrería

Para instalar mcp-server-opensearch para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @ibrooksSDX/mcp-server-opensearch --client claude

Uso de uv (recomendado)

Al utilizar uv no se necesita ninguna instalación específica para ejecutar directamente mcp-server-opensearch .

uv run mcp-server-opensearch \ --opensearch-url "http://localhost:9200" \ --index-name "my_index" \

o

uv run fastmcp run demo.py:main

Pruebas - Cliente de búsqueda abierta local

uv run python src/mcp-server-opensearch/test_opensearch.py

Pruebas: Conexión del servidor MCP al cliente de búsqueda abierta

cd src/mcp-server-opensearch uv run fastmcp dev demo.py

Uso con Claude Desktop

Para usar este servidor con la aplicación Claude Desktop, agregue la siguiente configuración a la sección "mcpServers" de su claude_desktop_config.json :

{ "opensearch": { "command": "uvx", "args": [ "mcp-server-opensearch", "--opensearch-url", "http://localhost:9200", "--opensearch-api-key", "your_api_key", "--index-name", "your_index_name" ] }, "Demo": { "command": "uv", "args": [ "run", "--with", "fastmcp", "--with", "opensearch-py", "fastmcp", "run", "/Users/ibrooks/Documents/GitHub/mcp-server-opensearch/src/mcp-server-opensearch/demo.py" ] } }

O utilice la interfaz de usuario FastMCP para instalar el servidor en Claude

uv run fastmcp install demo.py

Variables de entorno

La configuración del servidor también se puede realizar mediante variables de entorno:

  • OPENSEARCH_HOST : URL del servidor OpenSearch, por ejemplo http://localhost
  • OPENSEARCH_HOSTPORT : Puerto del host del servidor OpenSearch 9200
  • INDEX_NAME : Nombre del índice a utilizar
-
security - not tested
A
license - permissive license
-
quality - not tested

Proporciona una capa de memoria semántica que integra LLM con OpenSearch, lo que permite el almacenamiento y la recuperación de memorias dentro del motor OpenSearch.

  1. Under Contruction
    1. Current Blocker - Async Client from OpenSearch isn't installing
    2. Overview
    3. Components
    4. Installation
    5. Testing - Local Open Search Client
    6. Testing - MCP Server Connection to Open Search Client
    7. Usage with Claude Desktop
    8. Environment Variables
ID: n8ldec4vzj