MCP

基本能力

产品定位

MCP（Model Context Protocol）是一个实验性的协议，用于与Algolia API进行交互。该项目提供了一个Algolia MCP服务器的原型，允许用户通过MCP协议与Algolia的搜索服务进行交互。

核心功能

• 与Algolia API交互
• 支持搜索、添加、更新和配置索引
• 支持通过环境变量配置Algolia的APP ID、索引名称和API密钥
• 支持与Ollama等本地模型一起使用

适用场景

• 实验性项目开发
• 本地开发环境
• 与Algolia搜索服务交互的测试

工具列表

• MCP Inspector：用于检查MCP功能并手动运行它们
• mcphost：用于本地运行MCP服务器并与Ollama等模型一起使用

常见问题解答

• 安装后可以做什么？
• 搜索索引中的产品
• 添加JSON对象到索引
• 更新索引的可搜索属性
• 配置索引的排名规则
• 哪里可以了解更多关于Algolia MCP服务器的信息？
• 可以参考这篇博客文章
• 资源模板和根目前不支持
• 这是一个已知问题，可能尚未正式发布

使用教程

使用依赖

• Go：需要安装Go语言环境 shell $ go install https://go.dev/doc/install

安装教程

1. 克隆仓库并构建MCP服务器 shell $ git clone [email protected]:algolia/mcp.git $ cd mcp/cmd/mcp $ go build
2. 获取构建后的服务器二进制文件路径 shell $ pwd /path/to/the/repo/cmd/mcp
3. 更新Claude desktop设置，添加Algolia服务器定义 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>", "ALGOLIA_WRITE_API_KEY": "<ADMIN_API_KEY>" } } } }
4. 重启Claude desktop

调试方式

1. 设置环境变量 shell $ export ALGOLIA_APP_ID="" $ export ALGOLIA_INDEX_NAME="" $ export ALGOLIA_API_KEY="" $ export ALGOLIA_WRITE_API_KEY=""
2. 进入服务器目录并重新构建（如果需要） shell $ cd cmd/mcp $ go build
3. 运行MCP Inspector shell $ npx @modelcontextprotocol/inspector ./mcp

与Ollama一起使用

1. 创建配置文件 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>" } } } }
2. 运行mcphost shell $ go run github.com/mark3labs/mcphost@latest --config ~/mcp.json -m ollama:qwen2.5:3b

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。