Skip to main content
Glama

mcpify

将任何 API 转换为 MCP 服务器。一条命令。无需代码。

npm License: MIT CI

npx mcpify https://petstore3.swagger.io/api/v3/openapi.json
✓ mcpify: Petstore v1.0.0 — 19 tools
  base: https://petstore3.swagger.io/api/v3
  transport: stdio

就是这样。你的 AI 智能体现在可以访问整个 Petstore API 了。无需安装 SDK,无需编写胶水代码,无需部署服务器。

指向任何 OpenAPI 规范 → 获得一个功能完备的 MCP 服务器。


为什么选择它

每个构建智能体的团队都会遇到同样的障碍:模型需要调用 API,而连接每一个 API 都意味着数天的定制 MCP 服务器代码、模式转换和身份验证管道工作。

mcpify 将这一切简化为一条命令。OpenAPI 规范已经描述了一切——端点、参数、模式、身份验证。我们在运行时将其转换为 MCP 服务器,无需代码生成步骤,也无需维护源代码文件。

Related MCP server: mcpify

安装

按需使用 npx(推荐):

npx mcpify <spec>

或者全局安装:

npm install -g mcpify

需要 Node.js 18+。

使用

从托管规范使用

npx mcpify https://api.example.com/openapi.json

从本地文件使用(JSON 或 YAML)

npx mcpify ./spec.yaml

从单个 curl 命令使用

npx mcpify --curl "curl -H 'Authorization: Bearer xxx' https://api.github.com/user/repos"

从任何 curl 命令生成单工具 MCP 服务器。请求体会被解析并转换为输入模式。

列出工具而不启动服务

npx mcpify list ./spec.json

生成一个独立、可手动编辑的项目

npx mcpify generate ./spec.json ./my-mcp
cd my-mcp && npm install && npm start

当你想要修改行为时使用此功能——添加缓存、自定义身份验证流程、后处理等任何内容。

身份验证

在启动前设置环境变量。mcpify 会读取规范中的 securitySchemes 并自动匹配它们。

# HTTP bearer schemes
export MCPIFY_BEARER_TOKEN=xxx

# apiKey schemes (header or query, as the spec says)
export MCPIFY_API_KEY=xxx

# HTTP basic
export MCPIFY_BASIC_AUTH=user:password

# Per-scheme override (use the scheme's name from the spec)
export MCPIFY_AUTH_<SCHEME_NAME>=xxx

# Free-form extra headers on every request
export MCPIFY_HEADERS='{"X-Trace-Id":"abc","X-Internal":"1"}'

过滤大型规范

Stripe 的完整 OpenAPI 包含约 600 个端点。大多数智能体不需要全部这些端点,且大多数客户端也无法处理这么多工具。进行裁剪:

# Only the customers tag
npx mcpify ./stripe.json --tag customers

# Only operations whose tool name matches a regex
npx mcpify ./stripe.json --filter "^createCustomer|^getCustomer"

# Hard cap
npx mcpify ./stripe.json --max-tools 30

与 Claude Desktop 一起使用

~/.config/claude/claude_desktop_config.json (Linux/macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "petstore": {
      "command": "npx",
      "args": ["-y", "mcpify", "https://petstore3.swagger.io/api/v3/openapi.json"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "mcpify", "--curl",
        "curl -H 'Authorization: Bearer ghp_xxx' https://api.github.com/user/repos"]
    }
  }
}

与 Cursor / Cline / Claude Code 一起使用

同样的思路——只要你能通过 commandargs 配置 MCP 服务器的地方,它都能工作。mcpify 使用 stdio 进行通信。

# Claude Code:
claude mcp add petstore -- npx -y mcpify https://petstore3.swagger.io/api/v3/openapi.json

编程 API

import { loadOpenApiSpec, parseOpenApi, serve } from "mcpify";

const raw = await loadOpenApiSpec("./spec.yaml");
const spec = parseOpenApi(raw);
await serve(spec, {
  baseUrl: "https://staging.example.com",
  filterTag: "users",
});

工作原理

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   OpenAPI spec  │ ─→ │ mcpify  runtime │ ─→ │   MCP client    │
│  (JSON / YAML)  │    │  (stdio server) │    │ (Claude/Cursor) │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                            │
                            ↓ tool call
                       ┌─────────┐
                       │  fetch  │ → your API
                       └─────────┘
  1. 解引用规范(解析 $ref)。

  2. 将每个操作转换为 MCP 工具:路径/查询/头部参数变为输入属性;请求体变为嵌套的 body 属性。

  3. 在工具调用时,构建 URL,附加来自环境变量的身份验证信息,发送请求,并返回响应。

无需代码生成。无需重启循环。规范就是事实来源。

局限性

  • 流式响应体 — 目前已缓冲,上限为 64KB。

  • OAuth2 流程 — 不会自动运行;请通过 MCPIFY_BEARER_TOKEN 提供预先获取的令牌。

  • 文件上传 (multipart/form-data) — 尚不支持。

  • Webhooks / 回调 — 超出范围。

  • Swagger 2.0 — 部分支持;为获得最佳效果,请先转换为 OpenAPI 3。

欢迎提交 PR 改进上述内容。

开发

git clone https://github.com/qualuo/mcpify
cd mcpify
npm install
npm run build
npm test

许可证

MIT

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Automatically converts Swagger/OpenAPI specifications into MCP servers, enabling AI agents to interact with any REST API through natural language by exposing endpoints as AI-friendly tools.
    3
  • A
    license
    Not graded
    quality
    B
    maintenance
    Converts any OpenAPI specification into an MCP server, allowing AI assistants to interact with REST APIs through natural language.
    9
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Turns any OpenAPI REST or GraphQL API into an MCP server, allowing AI assistants like Claude to interact with APIs without writing code.
    18
    MIT

View all related MCP servers

Related MCP Connectors

  • Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

  • MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

  • MCP server for secureFlows: token-free URL builders and integration-linting tools for AI agents.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/qualuo/mcpify'

If you have feedback or need assistance with the MCP directory API, please join our Discord server