acuvity/mcp-server-algolia

mcp-server-algolia 镜像文档

镜像概述和主要用途

mcp-server-algolia是一个用于与Algolia API交互的MCP服务器，支持搜索、分析、监控和数据管理功能。该镜像由Acuvity基于algolia/mcp-node原始源代码打包，并发布到其MCP服务器 registry。它提供了安全隔离的运行环境，适用于需要与Algolia服务集成的代理系统和开发工具。

核心功能和特性

安全特性

隔离的不可变沙箱

运行时安全和防护措施

Minibridge集成：Minibridge建立安全的Agent-to-MCP连接，支持基于Rego/HTTP的策略执行，并简化编排。容器内置Rego策略，提供以下运行时防护：

注意：默认情况下，除resource integrity外所有防护措施均关闭，可单独启用或禁用。

使用场景和适用范围

适用于需要与Algolia服务集成的各类场景，包括：

• 开发环境中的Algolia API测试和调试
• 代理系统中与Algolia的安全数据交互
• IDE集成（如VS Code、Cursor等）以增强Copilot体验
• Kubernetes集群中的Algolia服务管理和监控

详细使用方法和配置说明

环境变量和配置参数

客户端集成

Visual Studio Code

一键安装：

全局配置： 打开用户设置JSON（ctrl + shift + p → Preferences: Open User Settings JSON），添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-algolia": {
        "env": {
          "ALGOLIA_CREDENTIALS": "TO_BE_SET"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "--tmpfs",
          "/tmp:rw,nosuid,nodev",
          "-e",
          "ALGOLIA_CREDENTIALS",
          "docker.io/acuvity/mcp-server-algolia:v0.0.8"
        ]
      }
    }
  }
}

工作区配置： 在工作区创建.vscode/mcp.json：

json
{
  "servers": {
    "acuvity-mcp-server-algolia": {
      "env": {
        "ALGOLIA_CREDENTIALS": "TO_BE_SET"
      },
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "--tmpfs",
        "/tmp:rw,nosuid,nodev",
        "-e",
        "ALGOLIA_CREDENTIALS",
        "docker.io/acuvity/mcp-server-algolia:v0.0.8"
      ]
    }
  }
}

Windsurf IDE

在~/.codeium/windsurf/mcp_config.json添加：

json
{
  "mcpServers": {
    "acuvity-mcp-server-algolia": {
      "env": {
        "ALGOLIA_CREDENTIALS": "TO_BE_SET"
      },
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "--tmpfs",
        "/tmp:rw,nosuid,nodev",
        "-e",
        "ALGOLIA_CREDENTIALS",
        "docker.io/acuvity/mcp-server-algolia:v0.0.8"
      ]
    }
  }
}

OpenAI Python SDK

本地运行：

python
async with MCPServerStdio(
    params={
        "env": {"ALGOLIA_CREDENTIALS":"TO_BE_SET"},
        "command": "docker",
        "args": ["run","-i","--rm","--read-only","--tmpfs","/tmp:rw,nosuid,nodev","-e","ALGOLIA_CREDENTIALS","docker.io/acuvity/mcp-server-algolia:v0.0.8"]
    }
) as server:
    tools = await server.list_tools()

Docker部署

本地STDIO模式

在客户端配置中设置：

• 命令：docker
• 参数：run -i --rm --read-only --tmpfs /tmp:rw,nosuid,nodev -e ALGOLIA_CREDENTIALS docker.io/acuvity/mcp-server-algolia:v0.0.8

本地HTTP/SSE模式

console
docker run -it -p 8000:8000 --rm --read-only --tmpfs /tmp:rw,nosuid,nodev -e ALGOLIA_CREDENTIALS docker.io/acuvity/mcp-server-algolia:v0.0.8

客户端配置：

json
{
  "mcpServers": {
    "acuvity-mcp-server-algolia": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Kubernetes部署（Helm）

安装要求

• 必需：ALGOLIA_CREDENTIALS密钥，通过secrets.ALGOLIA_CREDENTIALS设置
• 可选：HOME环境变量，通过env.HOME设置（默认：/tmp）

安装命令

console
helm install mcp-server-algolia oci://docker.io/acuvity/mcp-server-algolia --version 1.0.0

查看配置

console
helm show values oci://docker.io/acuvity/mcp-server-algolia --version 1.0.0

验证镜像签名

使用Cosign验证镜像完整性：

console
cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-algolia:latest

维护和支持

• 维护者：Acuvity团队（打包）、algolia（原始应用）
• 获取帮助：Acuvity MCP Forge仓库、Acuvity社区***、algolia/mcp-node
• 提交问题：Github issue tracker、algolia/mcp-node
• 支持架构：amd64、arm64
• 基础镜像：node:23.11.0-slim

工具列表

该服务器提供29种工具，详细列表请参考https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-algolia%E3%80%82