MCP 阿尔戈利亚

@algolia/mcp
0 Stars 16 次浏览 algolia 更新于 2026-08-23

阿尔戈利亚

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

MCP

此仓库包含用于与Algolia API交互的实验性模型上下文协议（或MCP）服务器。我们分享这个MCP仓库供您探索和试验。您可以自由地使用它、分叉它或在其基础上构建，但请注意，它不是由Algolia官方支持的，并且不受我们的SLA覆盖。我们可能会随时更新、破坏或完全移除它。如果您在此处自定义或配置某些内容，那么这些工作有可能会丢失。此外，在生产环境中使用MCP可能会影响您的Algolia使用。

如果您有任何反馈或想法（甚至是代码！），我们非常乐意听取。请知悉，我们可能会使用它来帮助改进我们的产品。此项目“按原样”和“可用状态”提供，没有任何保证或担保。特别明确：出于SLA目的，MCP不被视为“API客户端”。

安装

首先按照快速入门进行操作，这将安装Claude Desktop并设置一个示例Fileserver MCP服务器。这是使用MCP的一个很好的介绍，并且如果出现问题，您可以使用官方指南进行调试。

设置原型Algolia MCP服务器

要求：

克隆仓库并构建服务器

克隆仓库并构建mcp服务器：

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

我们需要获取构建好的服务器二进制文件的完整路径：

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

注意： 当将此命令添加到配置中时，必须指定二进制文件及其路径 (/path/to/the/repo/cmd/mcp/mcp)

更新设置以指向新服务器

在Claude桌面中编辑设置，按照https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server中的说明操作，并这次为algolia添加服务器定义（使用您之前找到的服务器路径）。

{
   "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 */
         }
      }
   }
}

重启Claude桌面，您应该会看到一个新的"algolia"工具可用。

调试

您可以运行Inspector（参见https://modelcontextprotocol.io/docs/tools/inspector）来检查MCP功能并手动运行它们。

从仓库根目录设置环境

$ 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

进入服务器目录，并根据需要重新构建：

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

在服务器上运行MCP Inspector：

$ npx @modelcontextprotocol/inspector ./mcp

与Ollama一起使用

实际上，您可以运行一个本地mcphost（它为您协调MCP服务器），然后通过Ollama在本地与其他模型一起使用它们。

我们使用https://github.com/mark3labs/mcphost来实现这一点。

按照README所述，您需要一个配置文件，因此您可以复制Claude的那个，并将其放在某个合理的位置以便在命令行中使用（例如~/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>"
         }
      }
   }
}

现在您可以直接运行它（无需检出仓库）：

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

常见问题

安装了这个MCP后我可以做些什么？

这里有一些示例提示来激发您的想象力：

  • “搜索索引中所有品牌为‘Nike’且价格小于100的产品。”
  • “将此JSON对象添加到blog_posts索引中。”
  • “更新recipes索引的可搜索属性，以包含成分。”
  • “配置我的索引，使nebula_award获奖者的排名更高”

我在哪里可以阅读更多关于Algolia MCP服务器的信息？

请参阅这篇博客文章，其中包括一个嵌入的演示视频。

Claude桌面版目前不支持资源模板和根

这个问题有点奇怪，因为网上有很多内容展示了这些模板，也许它还没有正式发布。

查看源码 项目主页