使用说明
项目简介
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:
- 访问 GitHub Releases 下载最新版本的 'algolia-mcp-node.zip' 文件。
- 解压下载的 '.zip' 文件到本地目录。
- 打开终端,导航到解压后的目录,移除可执行文件的隔离标记,允许程序执行(因为该可执行文件未进行 Apple 开发者签名):
将 '<解压目录>' 替换为实际的解压路径。xattr -r -d com.apple.quarantine <解压目录>/algolia-mcp - 运行身份验证命令,连接到您的 Algolia 账户:
此命令将自动打开浏览器,引导您登录 Algolia Dashboard 并完成授权。<解压目录>/algolia-mcp authenticate
Windows & Linux:
- Windows 和 Linux 版本的安装包正在开发中,敬请期待。
服务器配置
为了让 Claude Desktop 能够连接到 Algolia MCP Server,您需要在 Claude Desktop 的设置中添加 MCP 服务器配置。
-
打开 Claude Desktop 的设置 (Settings)。
-
在设置中找到 MCP Servers (或类似名称) 配置项。
-
添加一个新的 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'。
-
重启 Claude Desktop 使配置生效。
基本使用方法
-
确保 Algolia MCP Server 已成功配置并添加到 Claude Desktop 中。
-
在 Claude Desktop 中,您可以开始使用自然语言提问关于您的 Algolia 数据的问题。例如:
- "列出我的所有 Algolia 应用。"
- "我的 'products' 索引有多少条记录?"
- "在 'products' 索引中搜索价格低于 100 美元的 Nike 鞋子。"
- "过去一周,DE 地区 'products' 索引的无结果率是多少?使用 React 和 Recharts 生成图表。"
-
为了获得更精确的结果,建议在提问时明确指定应用程序和索引名称。
更多信息:
- 您可以参考 Model Context Protocol 官方文档 和仓库的 README.md 获取更详细的信息。
- 如果遇到问题,可以查看仓库的 Troubleshooting 部分或查阅日志文件进行诊断。
信息
分类
商业系统