该仓库包含用于与 Algolia API 交互的实验性模型上下文协议（MCP）服务器。我们分享这个 MCP 仓库供你探索和试验。你可以自由使用、分支或在其上构建——但请注意，它并非 Algolia 官方支持，也不在我们的 SLA 范围内。我们可能随时更新、破坏或完全移除。如果你在这里自定义或配置，可能会丢失工作。此外，在生产环境中使用 MCP 也会影响你的 Algolia 使用情况。

如果你有任何反馈或想法（甚至代码！），我们非常乐意听到。只要知道，我们可能会用它来帮助改进我们的产品。本项目以“现状”和“可用状态”提供，不保证或保修。明确说明：MCP在SLA方面不被视为“API客户端”。

安装

首先跟随快速入门，安装Claude Desktop并设置一个示例文件服务器MCP服务器。这是使用MCP的绝佳入门，如果遇到问题，你可以用官方指南调试。

建立原型 Algolia MCP 服务器

要求：

• 走 （https://go.dev/doc/install)

MCP

This repository contains experimental Model Context Protocol (or MCP) servers for interacting with Algolia APIs. This MCP repo is something we’re sharing for you to explore and experiment with. Feel free to use it, fork it, or build on top of it — but just know that it’s not officially supported by Algolia and isn’t covered under our SLA. We might update it, break it, or remove it entirely at any time. If you customize or configure things here, there’s a chance that work could be lost. Also, using MCP in production could affect your Algolia usage.

If you have feedback or ideas (even code!), we’d love to hear it. Just know that we might use it to help improve our products. This project is provided “as is” and “as available,” with no guarantees or warranties. To be super clear: MCP isn’t considered an “API Client” for SLA purposes.

Installation

First follow the quick start, which will install Claude Desktop and setup a sample Fileserver MCP server. This is a great introduction to using MCP and will let you debug things using the official guide if there are issues.

Setup the prototype Algolia MCP server

Requirements:

• Go (https://go.dev/doc/install)

Clone the repo and build the server

Clone the repo, amd build the mcp server:

$ git clone [email protected]:algolia/mcp.git
$ cd mcp/cmd/mcp
$ go build

We need to have the full path of the built server binary:

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

NOTE: When adding this command to your configuration, you must specify the binary along with the path (/path/to/the/repo/cmd/mcp/mcp)

Update the settings to point to the new server

In Claude desktop edit the settings as per https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server and this time add the server definition for algolia (using the server path that you found earlier).

{
   "mcpServers": {
      "algolia": {
         "command": "/path/to/the/repo/cmd/mcp/mcp",
         "env": {
            "ALGOLIA_APP_ID": "",
            "ALGOLIA_INDEX_NAME": "",
            "ALGOLIA_API_KEY": "",
            "ALGOLIA_WRITE_API_KEY": ""  /* if you want to allow write operations, use your ADMIN key here */
         }
      }
   }
}

Restart Claude desktop, and you should see a new "algolia" tool is available.

Debugging

You can run the Inspector (see https://modelcontextprotocol.io/docs/tools/inspector) to check the MCP features and run them manually.

From the repo root, setup the environment

$ 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

Move into the server directory, and rebuild (if necessary):

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