Skip to main content
Glama
Sign In
enesjakozh

Algolia

Official
by algolia
GitHub
Go
MIT License
18
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP

Este repositorio contiene servidores experimentales del Protocolo de Contexto de Modelo (o MCP) para interactuar con las API de Algolia. Compartimos este repositorio MCP para que lo explores y experimentes. Puedes usarlo, bifurcarlo o desarrollar sobre él, pero ten en cuenta que no cuenta con soporte oficial de Algolia ni está cubierto por nuestro Acuerdo de Nivel de Servicio (SLA). Podríamos actualizarlo, interrumpirlo o eliminarlo por completo en cualquier momento. Si personalizas o configuras algo aquí, podrías perder trabajo. Además, usar MCP en producción podría afectar tu uso de Algolia.

Si tienes comentarios o ideas (¡incluso código!), nos encantaría conocerlas. Ten en cuenta que podríamos usarlas para mejorar nuestros productos. Este proyecto se ofrece "tal cual" y "según disponibilidad", sin garantías. Para que quede claro: MCP no se considera un "cliente API" a efectos del SLA.

Instalación

Primero, siga la guía de inicio rápido , que instalará Claude Desktop y configurará un servidor Fileserver MCP de ejemplo. Esta es una excelente introducción al uso de MCP y le permitirá depurar problemas con la guía oficial si surge algún problema.

Configurar el prototipo de servidor MCP de Algolia

Requisitos:

Clonar el repositorio y construir el servidor

Clona el repositorio y compila el servidor mcp:

$ git clone git@github.com:algolia/mcp.git $ cd mcp/cmd/mcp $ go build

Necesitamos tener la ruta completa del binario del servidor compilado:

$ pwd /path/to/the/repo/cmd/mcp

NOTA: Al agregar este comando a su configuración, debe especificar el binario junto con la ruta ( /path/to/the/repo/cmd/mcp/mcp )

Actualice la configuración para que apunte al nuevo servidor

En el escritorio de Claude, edite la configuración según https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server y esta vez agregue la definición del servidor para algolia (usando la ruta del servidor que encontró anteriormente).

{ "mcpServers": { "algolia": { "command": "/path/to/the/repo/cmd/mcp/mcp", "env": { "ALGOLIA_APP_ID": "<APP_ID>", "ALGOLIA_INDEX_NAME": "<INDEX_NAME>", "ALGOLIA_API_KEY": "<API_KEY>", "ALGOLIA_WRITE_API_KEY": "<ADMIN_API_KEY>", /* if you want to allow write operations, use your ADMIN key here */ "MCP_ENABLED_TOOLS": "", /* optional: specify which tools to enable (e.g., "search,collections") */ "MCP_SERVER_TYPE": "stdio", /* optional: server type, either "stdio" (default) or "sse". If not set, defaults to "stdio" */ "MCP_SSE_PORT": "8080" /* optional: port for SSE server, default is 8080 (only used when MCP_SERVER_TYPE is "sse") */ } } } }

De forma predeterminada, todas las herramientas disponibles se habilitan cuando MCP_ENABLED_TOOLS está vacío o no se configura. Si desea habilitar solo herramientas específicas, puede configurar esta variable con una lista de nombres de herramientas separados por comas. Las herramientas disponibles son: abtesting, analytics, collections, monitoring, querysuggestions, recommended, search, search_read, search_write y usage.

  • search : Habilita todas las operaciones de búsqueda (tanto lectura como escritura)
  • search_read : habilita solo operaciones de lectura (listar índices, obtener configuraciones, ejecutar consultas, obtener objetos)
  • search_write : habilita solo operaciones de escritura (borrar, copiar, eliminar, mover, establecer configuraciones, eliminar objetos, insertar objetos)

Reinicie el escritorio de Claude y debería ver que hay una nueva herramienta "algolia" disponible.

Depuración

Puede ejecutar el Inspector (consulte https://modelcontextprotocol.io/docs/tools/inspector ) para verificar las características de MCP y ejecutarlas manualmente.

Desde la raíz del repositorio, configure el entorno

$ export ALGOLIA_APP_ID="" $ export ALGOLIA_INDEX_NAME="" $ export ALGOLIA_API_KEY="" $ export ALGOLIA_WRITE_API_KEY="" # if you want to allow write operations, use your ADMIN key here $ export MCP_ENABLED_TOOLS="" # if you want to restrict the tools activated you can optionally specify a list $ export MCP_SERVER_TYPE="stdio" # optional: server type, either "stdio" (default) or "sse". If not set, defaults to "stdio" $ export MCP_SSE_PORT="8080" # optional: port for SSE server, default is 8080 (only used when MCP_SERVER_TYPE is "sse")

Muévete al directorio del servidor y reconstruye (si es necesario):

$ cd cmd/mcp $ go build # might already be up-to-date

Ejecute el inspector MCP en el servidor:

$ npx @modelcontextprotocol/inspector ./mcp

Uso con Ollama

De hecho, puedes ejecutar un mcphost local (que organiza los servidores MCP para ti) y luego usarlos con otros modelos localmente a través de Ollama.

Estamos utilizando https://github.com/mark3labs/mcphost para esto.

Según el README , necesitas un archivo de configuración, para poder copiar el de Claude y colocarlo en algún lugar sensato para poder usarlo en la línea de comandos (por ejemplo, ~/mcp.json ).

{ "mcpServers": { "algolia": { "command": "/path/to/the/repo/cmd/mcp/mcp", "env": { "ALGOLIA_APP_ID": "<APP_ID>", "ALGOLIA_INDEX_NAME": "<INDEX_NAME>", "ALGOLIA_API_KEY": "<API_KEY>", "MCP_ENABLED_TOOLS": "", /* optional: specify which tools to enable (e.g., "search,collections") */ "MCP_SERVER_TYPE": "stdio", /* optional: server type, either "stdio" (default) or "sse". If not set, defaults to "stdio" */ "MCP_SSE_PORT": "8080" /* optional: port for SSE server, default is 8080 (only used when MCP_SERVER_TYPE is "sse") */ } } } }

De forma predeterminada, todas las herramientas disponibles se habilitan cuando MCP_ENABLED_TOOLS está vacío o no se configura. Si desea habilitar solo herramientas específicas, puede configurar esta variable con una lista de nombres de herramientas separados por comas. Las herramientas disponibles son: abtesting, analytics, collections, monitoring, querysuggestions, recommended, search, search_read, search_write y usage. Ahora puede ejecutarla directamente (sin necesidad de consultar el repositorio).

$ go run github.com/mark3labs/mcphost@latest --config ~/mcp.json -m ollama:qwen2.5:3b

Preguntas frecuentes

¿Qué tipo de cosas puedo hacer una vez que instale este MCP?

A continuación se muestran algunos ejemplos de indicaciones para estimular su imaginación:

  • “Buscar todos los productos en el índice donde la marca = 'Nike' y el precio < 100.”
  • “Agregue este objeto JSON al índice blog_posts”.
  • “Actualice los atributos de búsqueda del índice de recetas para incluir ingredientes”.
  • Configurar mi índice para que los ganadores del premio nebula_award tengan una mejor clasificación.

¿Dónde puedo leer más sobre el servidor MCP de Algolia?

Consulte esta publicación de blog que incluye un video de demostración incorporado.

Las plantillas de recursos y la raíz no son compatibles con el escritorio Claude en este momento

Este es un caso extraño , ya que hay mucho contenido en línea que muestra las plantillas; tal vez todavía no esté disponible en GA.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Algolia

  1. Instalación
    1. Configurar el prototipo de servidor MCP de Algolia
      1. Clonar el repositorio y construir el servidor
      2. Actualice la configuración para que apunte al nuevo servidor
    2. Depuración
      1. Uso con Ollama
        1. Preguntas frecuentes
          1. ¿Qué tipo de cosas puedo hacer una vez que instale este MCP?
          2. ¿Dónde puedo leer más sobre el servidor MCP de Algolia?
          3. Las plantillas de recursos y la raíz no son compatibles con el escritorio Claude en este momento

        Related MCP Servers

        • Alpaca Trading MCP Server

          laukikk
          -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that interfaces with Alpaca trading API, allowing users to manage portfolios, place trades, and access market data through natural language interactions.
          Last updated -
          Python

        • Mailmodoofficial

          mailmodo
          A
          security
          A
          license
          A
          quality
          Mailmodo
          Last updated -
          12
          134
          TypeScript
          GPL 3.0
          • Apple
          • Linux

        View all related MCP servers

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/algolia/mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server