컴퓨터에 Node.js가 설치되어 있는지 확인하세요.
Claude Desktop을 열고 설정 > 개발자로 이동하세요.
구성 파일을 편집합니다(파일이 없으면 새로 생성됩니다).
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
다음 구성을 추가합니다(필요에 따라 사용자 정의):

지엑스피1

Claude Desktop을 다시 시작하세요
이제 채팅 입력란에 망치 아이콘이 표시됩니다. 망치 아이콘을 클릭하여 API 도구에 접속하세요.

구성 사용자 정의

다양한 옵션으로 MCP 서버를 사용자 정의하려면 args 배열을 조정할 수 있습니다.

{
  "mcpServers": {
    "my-api": {
      "command": "npx",
      "args": [
        "-y",
        "@tyk-technologies/api-to-mcp",
        "--spec",
        "./path/to/your/openapi.json",
        "--overlays",
        "./path/to/overlay.json,https://example.com/api/overlay.json",
        "--whitelist",
        "getPet*,POST:/users/*",
        "--targetUrl",
        "https://api.example.com"
      ],
      "enabled": true
    }
  }
}

커서 설정

다음 위치 중 하나에 구성 파일을 만듭니다.
- 프로젝트별: 프로젝트 디렉토리의 .cursor/mcp.json
- 글로벌: 홈 디렉토리의 ~/.cursor/mcp.json
다음 구성을 추가합니다(API에 맞게 필요에 따라 조정):

{
  "servers": [
    {
      "command": "npx",
      "args": [
        "-y",
        "@tyk-technologies/api-to-mcp",
        "--spec",
        "./path/to/your/openapi.json"
      ],
      "name": "My API Tools"
    }
  ]
}

커서를 다시 시작하거나 창을 다시 로드하세요

Vercel AI SDK와 함께 사용

Vercel AI SDK의 MCP 클라이언트를 사용하여 JavaScript/TypeScript 애플리케이션에서 이 MCP 서버를 직접 사용할 수도 있습니다.

import { experimental_createMCPClient } from 'ai';
import { Experimental_StdioMCPTransport } from 'ai/mcp-stdio';
import { generateText } from 'ai';
import { createGoogleGenerativeAI } from '@ai-sdk/google';

// Initialize the Google Generative AI provider
const google = createGoogleGenerativeAI({
  apiKey: process.env.GOOGLE_API_KEY, // Set your API key in environment variables
});
const model = google('gemini-2.0-flash');

// Create an MCP client with stdio transport
const mcpClient = await experimental_createMCPClient({
  transport: {
    type: 'stdio',
    command: 'npx', // Command to run the MCP server
    args: ['-y', '@tyk-technologies/api-to-mcp', '--spec', 'https://petstore3.swagger.io/api/v3/openapi.json'], // OpenAPI spec
    env: {
      // You can set environment variables here
      // API_KEY: process.env.YOUR_API_KEY,
    },
  },
});

async function main() {
  try {
    // Retrieve tools from the MCP server
    const tools = await mcpClient.tools();

    // Generate text using the AI SDK with MCP tools
    const { text } = await generateText({
      model,
      prompt: 'List all available pets in the pet store using the API.',
      tools, // Pass the MCP tools to the model
    });

    console.log('Generated text:', text);
  } catch (error) {
    console.error('Error:', error);
  } finally {
    // Always close the MCP client to release resources
    await mcpClient.close();
  }
}

main();

구성

구성은 환경 변수, 명령줄 옵션 또는 JSON 구성 파일을 통해 관리됩니다.

명령줄 옵션

# Start with specific OpenAPI spec file
@tyk-technologies/api-to-mcp --spec=./path/to/openapi.json

# Apply overlays to the spec
@tyk-technologies/api-to-mcp --spec=./path/to/openapi.json --overlays=./path/to/overlay.json,https://example.com/api/overlay.json

# Include only specific operations (supports glob patterns)
@tyk-technologies/api-to-mcp --spec=./path/to/openapi.json --whitelist="getPet*,POST:/users/*"

# Specify target API URL
@tyk-technologies/api-to-mcp --spec=./path/to/openapi.json --targetUrl=https://api.example.com

# Add custom headers to all API requests
@tyk-technologies/api-to-mcp --spec=./path/to/openapi.json --headers='{"X-Api-Version":"1.0.0"}'

# Disable the X-MCP header
@tyk-technologies/api-to-mcp --spec=./path/to/openapi.json --disableXMcp

환경 변수

.env 파일이나 환경에서 직접 설정할 수 있습니다.

OPENAPI_SPEC_PATH : OpenAPI 사양 파일 경로
OPENAPI_OVERLAY_PATHS : JSON 파일을 오버레이하기 위한 쉼표로 구분된 경로
TARGET_API_BASE_URL : API 호출을 위한 기본 URL(OpenAPI 서버보다 우선함)
MCP_WHITELIST_OPERATIONS : 포함할 작업 ID 또는 URL 경로의 쉼표로 구분된 목록( getPet* 또는 GET:/pets/* 와 같은 glob 패턴 지원)
MCP_BLACKLIST_OPERATIONS : 제외할 작업 ID 또는 URL 경로의 쉼표로 구분된 목록(글로브 패턴 지원, 허용 목록 사용 시 무시됨)
API_KEY : 대상 API에 대한 API 키(필요한 경우)
SECURITY_SCHEME_NAME : API 키가 필요한 보안 체계의 이름
SECURITY_CREDENTIALS : 여러 체계에 대한 보안 자격 증명을 포함하는 JSON 문자열
CUSTOM_HEADERS : 모든 API 요청에 포함할 사용자 정의 헤더를 포함하는 JSON 문자열
HEADER_* : HEADER_ 로 시작하는 모든 환경 변수는 사용자 정의 헤더로 추가됩니다(예: HEADER_X_API_Version=1.0.0 헤더 X-API-Version: 1.0.0 추가합니다)
DISABLE_X_MCP : 모든 API 요청에 X-MCP: 1 헤더를 추가하는 것을 비활성화하려면 true 로 설정합니다.
CONFIG_FILE : JSON 구성 파일의 경로

JSON 구성

환경 변수나 명령줄 옵션 대신 JSON 구성 파일을 사용할 수도 있습니다. MCP 서버는 다음 순서로 구성 파일을 찾습니다.

--config 명령줄 옵션으로 지정된 경로
CONFIG_FILE 환경 변수에 의해 지정된 경로
현재 디렉토리의 config.json
현재 디렉토리의 openapi-mcp.json
현재 디렉토리의 .openapi-mcp.json

JSON 구성 파일 예:

{
  "spec": "./path/to/openapi-spec.json",
  "overlays": "./path/to/overlay1.json,https://example.com/api/overlay.json",
  "targetUrl": "https://api.example.com",
  "whitelist": "getPets,createPet,/pets/*",
  "blacklist": "deletePet,/admin/*",
  "apiKey": "your-api-key",
  "securitySchemeName": "ApiKeyAuth",
  "securityCredentials": {
    "ApiKeyAuth": "your-api-key",
    "OAuth2": "your-oauth-token"
  },
  "headers": {
    "X-Custom-Header": "custom-value",
    "User-Agent": "OpenAPI-MCP-Client/1.0"
  },
  "disableXMcp": false
}

설명이 포함된 전체 예제 구성 파일은 루트 디렉토리의 config.example.json 에서 확인할 수 있습니다.

구성 우선 순위

구성 설정은 다음 우선 순위(가장 높은 것부터 가장 낮은 것까지)에 따라 적용됩니다.

명령줄 옵션
환경 변수
JSON 구성 파일

개발

설치

# Clone the repository
git clone <repository-url>
cd openapi-to-mcp-generator

# Install dependencies
npm install

# Build the project
npm run build

로컬 테스트

# Start the MCP server
npm start

# Development mode with auto-reload
npm run dev

나만의 버전 사용자 지정 및 게시

이 저장소를 기반으로 MCP 서버에 대한 맞춤형 OpenAPI를 생성할 수 있습니다. 이 섹션에서는 저장소를 포크하고, 특정 API에 맞게 사용자 정의하고, 패키지로 게시하는 방법을 설명합니다.

포킹 및 사용자 정의

저장소 포크 : GitHub에서 이 저장소를 포크하여 사용자 정의가 가능한 사본을 만드세요.

OpenAPI 사양을 추가하세요 :

# Create a specs directory if it doesn't exist
mkdir -p specs

# Add your OpenAPI specifications
cp path/to/your/openapi-spec.json specs/

# Add any overlay files
cp path/to/your/overlay.json specs/

기본 설정 구성 : 패키지와 함께 제공될 사용자 지정 구성 파일을 만듭니다.

# Copy the example config
cp config.example.json config.json

# Edit the config to point to your bundled specs
# and set any default settings

package.json 업데이트 :

{
  "name": "your-custom-mcp-server",
  "version": "1.0.0",
  "description": "Your customized MCP server for specific APIs",
  "files": [
    "dist/**/*",
    "config.json",
    "specs/**/*",
    "README.md"
  ]
}

사양이 번들로 포함되어 있는지 확인하세요 . package.json의 files 필드(위에 표시됨)는 사양 및 구성 파일이 게시된 패키지에 포함되도록 보장합니다.

GitHub 워크플로 사용자 지정

이 저장소에는 npm에 자동 게시하는 GitHub Actions 워크플로가 포함되어 있습니다. 포크된 저장소에 맞게 사용자 지정하려면 다음을 수행하세요.

워크플로 이름 업데이트 : 원하는 경우 .github/workflows/publish-npm.yaml 편집하여 이름을 업데이트합니다.
```
name: Publish My Custom MCP Package
```

패키지 범위 설정(필요한 경우) : npm 조직 범위에 따라 게시하려면 워크플로 파일에서 범위 줄의 주석 처리를 제거하고 수정합니다.

- name: Setup Node.js
  uses: actions/setup-node@v4
  with:
    node-version: "18"
    registry-url: "https://registry.npmjs.org/"
    # Uncomment and update with your organization scope:
    scope: "@your-org"

npm 토큰 설정 : 포크된 저장소 설정에서 NPM_TOKEN 이라는 이름의 GitHub 비밀로 npm 토큰을 추가합니다.

맞춤형 패키지 게시

저장소를 사용자 지정한 후:

태그 생성 및 푸시 :

# Update version in package.json (optional, the workflow will update it based on the tag)
npm version 1.0.0

# Push the tag
git push --tags

GitHub Actions는 다음을 수행합니다 .
- 패키지를 자동으로 빌드합니다
- package.json의 버전을 태그와 일치하도록 업데이트합니다.
- 번들 사양 및 구성으로 npm에 게시

출판 후 사용

사용자 정의 패키지 사용자는 npm을 사용하여 해당 패키지를 설치하고 사용할 수 있습니다.

# Install your customized package
npm install your-custom-mcp-server -g

# Run it
your-custom-mcp-server

구성 섹션에 설명된 대로 환경 변수나 명령줄 옵션을 통해 기본 설정을 재정의할 수 있습니다.

특허

MIT

Available Tools

3 tools

createPetD

ParametersJSON Schema

Name	Required	Description	Default
`requestBody`	Yes	Parameter: requestBody

TDQS

D1/5.0

Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

getPetByIdD

ParametersJSON Schema

Name	Required	Description	Default
`petId`	Yes	Enhanced pet ID description from overlay

TDQS

D1/5.0

Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

listPetsD

ParametersJSON Schema

Name	Required	Description	Default
`limit`	No	How many items to return at one time

TDQS

D1/5.0

Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

3 tool updatesv1.0.0Jul 25, 2025
- First observedcreatePet
- First observedgetPetById
- First observedlistPets

Deploy Server

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

TDQS

D1.9/5.0

Scored 2026-04-18 10:20 across 3 tools

Disambiguation5/5

The three tools have clearly distinct purposes: createPet for creating a pet, getPetById for retrieving a specific pet by ID, and listPets for listing all pets. There is no overlap or ambiguity between these operations, making it easy for an agent to select the correct tool based on the desired action.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern: createPet, getPetById, and listPets. The naming is uniform, with no mixing of conventions (e.g., snake_case or camelCase variations), making the set predictable and readable.

Tool Count3/5

With only 3 tools, the server feels thin for a general OpenAPI-to-MCP conversion purpose, which might imply broader functionality. However, for a specific pet-related API subset, this count is minimal but covers basic CRUD operations (create, read, list), though it lacks update and delete tools.

Completeness3/5

The tool set covers create, get by ID, and list operations, providing a basic CRUD foundation for pets. However, it lacks update and delete tools, which are common in such domains, and there are no tools for other potential resources or advanced operations, indicating notable gaps in coverage.

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

Swagger MCPOAuth
com.smartbear
MCP server for AI access to Swagger by SmartBear.
API Testing Documentation Access Developer Tools
144
OneSchema MCP Server
co.oneschema
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Data Platforms App Automation
1
hithereiamaliff-mcp-nextcloudOAuth
ai.smithery
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Cloud Storage File Systems Workplace & Productivity
238
simceptorOAuth
io.github.ayda212
AI-native mock API server with MCP. Create REST/SOAP mocks from Claude, Cursor, or Windsurf.
API Testing Testing & QA Tools
2

Related MCP Servers

Mcp-Swagger-Server
Cloud Platforms Developer Tools Embedded system
zaizaizhao
A
license
Not graded
quality
B
maintenance
A Model Context Protocol (MCP) server that converts OpenAPI/Swagger specifications to MCP format, enabling AI assistants to interact with REST APIs through standardized protocol.
Updated 2 months ago (2026-08-12 01:35 UTC)
77
TypeScript
MIT
Swagger MCP
API Testing Developer Tools RAG Systems
kyle-pena-nlp
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.
Updated a year ago (2025-08-05 20:59 UTC)
3
-
mcpify
Developer Tools API Testing
bahri-hirfanoglu
A
license
Not graded
quality
C
maintenance
Converts any OpenAPI specification into an MCP server, allowing AI assistants to interact with REST APIs through natural language.
Updated 3 months ago (2026-07-02 18:36 UTC)
9 npm
1
MIT
swagger-mcp-server
Developer Tools API Testing Documentation Access
salacoste
F
license
Not graded
quality
D
maintenance
Converts any Swagger/OpenAPI specification into an MCP server, enabling AI assistants to intelligently query API endpoints, schemas, and generate code examples.
Updated a year ago (2025-10-02 00:34 UTC)
18
-

OpenAPI에서 MCP 서버로

개요

특징

AI 어시스턴트와 함께 사용

Claude Desktop 설정

구성 사용자 정의

커서 설정

Vercel AI SDK와 함께 사용

구성

명령줄 옵션

환경 변수

JSON 구성

구성 우선 순위

개발

설치

로컬 테스트

나만의 버전 사용자 지정 및 게시

포킹 및 사용자 정의

GitHub 워크플로 사용자 지정

맞춤형 패키지 게시

출판 후 사용

특허

Available Tools

Tool Schema Changelog

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Appeared in Searches