acuvity/mcp-server-openapi-schema

mcp-server-openapi-schema镜像介绍

镜像概述

acuvity/mcp-server-openapi-schema镜像用于暴露OpenAPI schema，让大语言模型（LLM）能够探索和理解API结构。该镜像由Acuvity基于开源项目mcp-openapi-schema打包，提供安全可靠的运行环境，支持多种集成场景。

核心功能

1. OpenAPI schema暴露：为LLM提供API接口规范，支持工具调用场景。
2. 多客户端兼容：适配VS Code、Windsurf IDE、Cursor IDE、Claude Desktop及OpenAI Python SDK等。
3. 安全防护：
   • 非root默认运行，遵循最小权限原则；
   • 只读文件系统防止未授权修改；
   • 持续CVE扫描与镜像签名（Cosign）确保完整性；
   • 内置Rego策略支持敏感数据检测、schema合规性检查等运行时防护。

使用场景

• LLM工具调用时辅助模型理解API；
• 开发环境集成MCP服务器增强AI编程能力；
• 企业级Kubernetes集群中安全部署服务。

配置说明

环境变量

• SCHEMA_PATH：必填，指定OpenAPI schema文件路径。

Docker部署示例

本地HTTP/SSE模式

bash
docker run -it -p 8000:8000 --rm --read-only -e SCHEMA_PATH=your_schema_path docker.io/acuvity/mcp-server-openapi-schema:0.0.1

客户端配置：

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

Kubernetes部署（Helm）

安装Chart

bash
helm install mcp-server-openapi-schema oci://docker.io/acuvity/mcp-server-openapi-schema --version 1.0.0 --set env.SCHEMA_PATH=your_schema_path

客户端集成（VS Code）

用户设置JSON添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-openapi-schema": {
        "env": {"SCHEMA_PATH": "你的schema路径"},
        "command": "docker",
        "args": ["run","-i","--rm","--read-only","-e","SCHEMA_PATH","docker.io/acuvity/mcp-server-openapi-schema:0.0.1"]
      }
    }
  }
}