APIMatic MCP

官方

APIMatic MCP 服务器用于通过 APIMatic 验证 OpenAPI 规范。该服务器处理 OpenAPI 文件,并利用 APIMatic 的 API 返回验证摘要。

你可以用 Apimatic MCP 做什么?

  • 验证OpenAPI规范 — 让助手对附带的OpenAPI 2.0或3.0文件(JSON或YAML)运行validate-openapi-using-apimatic,并返回验证摘要。
  • 获取结构化验证报告 — 直接在对话中接收APIMatic的全面验证结果,包括发现的任何错误或警告。
  • 在实现前检查API定义 — 尽早验证OpenAPI文件,以便在生成SDK或文档之前发现规范问题。

文档

APIMatic Validator MCP 服务器

本仓库提供了一个模型上下文协议(MCP)服务器,用于通过 APIMatic 验证 OpenAPI 规范。该服务器利用 APIMatic 的 API 处理 OpenAPI 文件并返回验证摘要。

功能特性

  • 验证 OpenAPI 2.0 和 3.0 文件
  • 使用 APIMatic 的 API 进行全面验证
  • 支持 JSON 和 YAML 两种格式
  • 实现模型上下文协议(MCP),实现无缝集成

安装

请确保已安装 Node.js v18+

克隆仓库

git clone https://github.com/apimatic/apimatic-validator-mcp.git
cd apimatic-validator-mcp

安装依赖

npm install

构建项目

npm run build

配置

使用该服务器需要 APIMatic API 密钥。请在 APIMatic 注册并获取 API 密钥。

image

与 Claude Desktop 集成

修改 claude_desktop_config.json 文件以集成 MCP 服务器。如果该文件不存在,请在以下位置创建一个:

Windows

code $env:AppData\Claude\claude_desktop_config.json

macOS/Linux

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

将 MCP 服务器添加到配置中

{
    "mcpServers": {
        "APIMatic": {
            "command": "node",
            "args": [
                "C:\\PATH\\TO\\PARENT\\FOLDER\\build\\index.js"
            ],
            "env": {
                "APIMATIC_API_KEY": "<Add your APIMatic token here>"
            }
        }
    }
}

配置完成后,Claude Desktop 中应出现一个锤子图标。打开它即可验证 validate-openapi-using-apimatic 工具是否已成功集成。

使用方法

  1. 添加一个 OpenAPI 文件。
  2. 提供验证提示。
  3. 验证结果将会返回。

APIMatic MCP Server For OpenAPI Validation.webm