MCP服务器

基本能力

产品定位

MCP（模型上下文协议）是一种与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语言环境

  $ go install https://go.dev/doc/install
  

安装教程

1. 克隆仓库并构建MCP服务器

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

2. 获取构建的服务器二进制文件路径

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

3. 更新Claude桌面设置以添加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>"
            }
         }
      }
   }
   

4. 重启Claude桌面

调试方法

1. 设置环境变量

   $ export ALGOLIA_APP_ID=""
   $ export ALGOLIA_INDEX_NAME=""
   $ export ALGOLIA_API_KEY=""
   $ export ALGOLIA_WRITE_API_KEY=""
   

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

   $ cd cmd/mcp
   $ go build
   

3. 运行MCP Inspector

   $ npx @modelcontextprotocol/inspector ./mcp
   

与Ollama一起使用

1. 创建配置文件

   {
      "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

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