MCP Servers

模型上下文协议服务器、框架、SDK 和模板的综合目录。

O
Openapi To MCP
作者 @vect-G
GitHub 仓库(1 星标)

MCP server by vect-G

创建于 3/18/2026
更新于 about 4 hours ago
README
View Source
Repository documentation and setup instructions

openapi-to-mcp

CI Publish GitHub Release GitHub stars License

Turn any OpenAPI/Swagger spec into a runnable MCP server in one command.

30s Try

openapi-to-mcp run https://petstore3.swagger.io/api/v3/openapi.json

If it fails on your spec, open an OpenAPI Compatibility Request issue.

Why developers star this

  • Instant leverage: existing REST APIs become AI-callable tools.
  • Zero boilerplate: no hand-written MCP wrappers per endpoint.
  • Production-minded: filtering, naming rules, auth mapping, CI-ready packaging.
  • Handles real-world specs: supports external $ref files and Swagger 2 body params.

This exposes Petstore operations as MCP tools over stdio.

Quickstart (Conda)

conda create -y -n openapi-mcp python=3.11
conda run -n openapi-mcp python -m pip install -e .[dev]

conda run -n openapi-mcp openapi-to-mcp run examples/store.yaml --dry-run

Expected output includes generated tools like:

  • listproducts
  • getorder
  • createorder
  • internalhealth

Commands

openapi-to-mcp run <source> [options]
openapi-to-mcp list <source> [options]
openapi-to-mcp mcp-config <source> [options]
openapi-to-mcp init-config [path]

Powerful options

  • --config: Load YAML/JSON config
  • --include-tags: Keep only matching tags
  • --exclude-tags: Drop matching tags
  • --only-operations: Include specific operationIds
  • --methods: Keep specific HTTP methods
  • --prefix: Prefix generated MCP tool names
  • --base-url: Override servers URL

Example:

openapi-to-mcp list examples/store.yaml \
  --include-tags orders \
  --methods get \
  --prefix shop \
  --json

Config file mode

Generate a starter file:

openapi-to-mcp init-config

openapi-to-mcp.yaml example:

runtime:
  base_url: https://api.example.com/v1
  timeout_seconds: 30

naming:
  prefix: shop

filters:
  include_tags: [orders]
  exclude_tags: [internal]
  operation_ids: []
  methods: [get, post]

Use it:

openapi-to-mcp run ./openapi.yaml --config openapi-to-mcp.yaml

MCP client config snippet

Generate a ready-to-paste JSON snippet:

openapi-to-mcp mcp-config examples/store.yaml --name demo

It outputs:

{
  "mcpServers": {
    "demo": {
      "command": "openapi-to-mcp",
      "args": ["run", "examples/store.yaml", "--name", "demo"],
      "env": {
        "OPENAPI_BEARER_TOKEN": "<your_token_if_needed>",
        "OPENAPI_API_KEY": "<your_api_key_if_needed>"
      }
    }
  }
}

Auth mapping

Common OpenAPI security types are mapped from environment variables:

  • API key: OPENAPI_API_KEY or OPENAPI_AUTH_<SCHEME_NAME>
  • Bearer/OAuth2/OpenID: OPENAPI_BEARER_TOKEN or OPENAPI_AUTH_<SCHEME_NAME>
  • Basic auth: OPENAPI_BASIC_USER + OPENAPI_BASIC_PASS or OPENAPI_AUTH_<SCHEME_NAME>=user:pass

Development

conda run -n openapi-mcp pytest -q

CI and release workflows are provided in .github/workflows/.

Limitations (current)

  • Response schema extraction is minimal
  • Focused on HTTP tools (no resource/prompt generation yet)

Docs

More examples

License

MIT

快速设置
此服务器的安装指南

安装包 （如果需要）

uvx openapi-to-mcp

Cursor 配置 (mcp.json)

{ "mcpServers": { "vect-g-openapi-to-mcp": { "command": "uvx", "args": [ "openapi-to-mcp" ] } } }