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]

Related MCP server: @git-fabric/aiana

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