使用说明

项目简介

Algolia MCP Server (mcp-node) 是 Algolia 官方提供的 MCP 服务器实现,它充当 Claude Desktop 等 LLM 应用与 Algolia 数据之间的桥梁。通过此服务器,用户可以使用自然语言指令,让 LLM 客户端(如 Claude Desktop)直接访问和操作 Algolia 中的数据,例如搜索索引、分析指标、管理应用等。

主要功能点

  • 连接 Algolia 数据与 LLM: 通过 Model Context Protocol (MCP) 将 Algolia 的强大功能集成到支持 MCP 协议的 LLM 客户端,如 Claude Desktop。
  • 自然语言操作 Algolia: 允许用户通过自然语言指令,指示 LLM 客户端执行各种 Algolia 操作,无需手动编写 API 代码。
  • 支持多种 Algolia 功能: 目前已支持 Algolia Search, Analytics, Recommend, AB Testing, Monitoring, Ingestion, Usage, Collections, Query Suggestions 等 API 功能。
  • 工具化操作: 将 Algolia 的各项功能封装为 MCP 工具 (Tools),方便 LLM 客户端调用。
  • 易于安装和配置: 提供预编译的可执行文件,简化安装过程,并提供清晰的配置指南。

安装步骤

macOS:

  1. 访问 GitHub Releases 下载最新版本的 'algolia-mcp-node.zip' 文件。
  2. 解压下载的 '.zip' 文件到本地目录。
  3. 打开终端,导航到解压后的目录,移除可执行文件的隔离标记,允许程序执行(因为该可执行文件未进行 Apple 开发者签名):
    xattr -r -d com.apple.quarantine <解压目录>/algolia-mcp
    将 '<解压目录>' 替换为实际的解压路径。
  4. 运行身份验证命令,连接到您的 Algolia 账户:
    <解压目录>/algolia-mcp authenticate
    此命令将自动打开浏览器,引导您登录 Algolia Dashboard 并完成授权。

Windows & Linux:

  • Windows 和 Linux 版本的安装包正在开发中,敬请期待。

服务器配置

为了让 Claude Desktop 能够连接到 Algolia MCP Server,您需要在 Claude Desktop 的设置中添加 MCP 服务器配置。

  1. 打开 Claude Desktop 的设置 (Settings)。

  2. 在设置中找到 MCP Servers (或类似名称) 配置项。

  3. 添加一个新的 MCP Server 配置,配置内容如下:

    {
      "mcpServers": {
        "algolia-mcp": {
          "command": "<可执行文件路径>"
        }
      }
    }
    • '"algolia-mcp"': 服务器名称,您可以自定义,用于在 Claude Desktop 中标识该服务器。
    • '"command"': 必须替换为 Algolia MCP Server 可执行文件的绝对路径。 例如,如果您将解压后的 'algolia-mcp' 文件放在了 '/Applications/algolia-mcp-node/' 目录下,则 '<可执行文件路径>' 应为 '/Applications/algolia-mcp-node/algolia-mcp'。
  4. 重启 Claude Desktop 使配置生效。

基本使用方法

  1. 确保 Algolia MCP Server 已成功配置并添加到 Claude Desktop 中。

  2. 在 Claude Desktop 中,您可以开始使用自然语言提问关于您的 Algolia 数据的问题。例如:

    • "列出我的所有 Algolia 应用。"
    • "我的 'products' 索引有多少条记录?"
    • "在 'products' 索引中搜索价格低于 100 美元的 Nike 鞋子。"
    • "过去一周,DE 地区 'products' 索引的无结果率是多少?使用 React 和 Recharts 生成图表。"
  3. 为了获得更精确的结果,建议在提问时明确指定应用程序和索引名称。

更多信息:

信息

分类

商业系统