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 密钥。
与 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 工具是否已成功集成。
使用方法
- 添加一个 OpenAPI 文件。
- 提供验证提示。
- 验证结果将会返回。