mcp-rest-api

MCP REST API 테스터

Cline을 통해 REST API를 테스트할 수 있는 TypeScript 기반 MCP 서버입니다. 이 도구를 사용하면 개발 환경에서 직접 모든 REST API 엔드포인트를 테스트하고 상호 작용할 수 있습니다.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 REST API 테스터를 자동으로 설치하려면:

지엑스피1

수동 설치

패키지를 전역으로 설치합니다.

npm install -g dkmaker-mcp-rest-api

Cline 사용자 정의 지침 구성:

클라인이 이 도구를 효과적으로 사용하는 방법을 이해하도록 하려면 클라인 사용자 정의 지침에 다음을 추가하세요(설정 > 사용자 정의 지침):

# REST API Testing Instructions

The `test_request` tool enables testing, debugging, and interacting with REST API endpoints. The tool provides comprehensive request/response information and handles authentication automatically.

## When to Use

- Testing specific API endpoints
- Debugging API responses
- Verifying API functionality
- Checking response times
- Validating request/response formats
- Testing local development servers
- Testing API sequences
- Verifying error handling

## Key Features

- Supports GET, POST, PUT, DELETE methods
- Handles authentication (Basic, Bearer, API Key)
- Normalizes endpoints automatically
- Provides detailed response information
- Configurable SSL verification and response limits

## Resources

The following resources provide detailed documentation:

- examples: Usage examples and common patterns
- response-format: Response structure and fields
- config: Configuration options and setup guide

Access these resources to understand usage, response formats, and configuration options.

## Important Notes

- Review API implementation for expected behavior
- Handle sensitive data appropriately
- Consider rate limits and API constraints
- Restart server after configuration changes

MCP 구성에 서버를 추가합니다.

이 지침은 Cline을 위한 것이지만, 서버는 모든 MCP 구현에서 작동합니다. 운영 체제에 따라 다음과 같이 구성하세요.

윈도우

⚠️ 중요 : Windows 경로 확인의 알려진 문제( 문제 #40 )로 인해 %APPDATA% 대신 전체 경로를 사용해야 합니다.

C:\Users\<YourUsername>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json 에 추가:

{
  "mcpServers": {
    "rest-api": {
      "command": "node",
      "args": [
        "C:/Users/<YourUsername>/AppData/Roaming/npm/node_modules/dkmaker-mcp-rest-api/build/index.js"
      ],
      "env": {
        "REST_BASE_URL": "https://api.example.com",
        // Basic Auth
        "AUTH_BASIC_USERNAME": "your-username",
        "AUTH_BASIC_PASSWORD": "your-password",
        // OR Bearer Token
        "AUTH_BEARER": "your-token",
        // OR API Key
        "AUTH_APIKEY_HEADER_NAME": "X-API-Key",
        "AUTH_APIKEY_VALUE": "your-api-key",
        // SSL Verification (enabled by default)
        "REST_ENABLE_SSL_VERIFY": "false", // Set to false to disable SSL verification for self-signed certificates
        // Response Size Limit (optional, defaults to 10000 bytes)
        "REST_RESPONSE_SIZE_LIMIT": "10000", // Maximum response size in bytes
        // Custom Headers (optional)
        "HEADER_X-API-Version": "2.0",
        "HEADER_Custom-Client": "my-client",
        "HEADER_Accept": "application/json"
      }
    }
  }
}

맥OS

~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 에 추가:

{
  "mcpServers": {
    "rest-api": {
      "command": "npx",
      "args": [
        "-y",
        "dkmaker-mcp-rest-api"
      ],
      "env": {
        "REST_BASE_URL": "https://api.example.com",
        // Basic Auth
        "AUTH_BASIC_USERNAME": "your-username",
        "AUTH_BASIC_PASSWORD": "your-password",
        // OR Bearer Token
        "AUTH_BEARER": "your-token",
        // OR API Key
        "AUTH_APIKEY_HEADER_NAME": "X-API-Key",
        "AUTH_APIKEY_VALUE": "your-api-key",
        // SSL Verification (enabled by default)
        "REST_ENABLE_SSL_VERIFY": "false", // Set to false to disable SSL verification for self-signed certificates
        // Custom Headers (optional)
        "HEADER_X-API-Version": "2.0",
        "HEADER_Custom-Client": "my-client",
        "HEADER_Accept": "application/json"
      }
    }
  }
}

참고: 환경 변수를 실제 값으로 바꾸세요. 한 번에 하나의 인증 방법만 구성하세요.

기본 인증(사용자 이름/비밀번호)
베어러 토큰(기본 인증이 구성되지 않은 경우)
API 키(기본 인증이나 베어러 토큰이 구성되지 않은 경우)

특징

다양한 HTTP 메서드를 사용하여 REST API 엔드포인트 테스트
GET, POST, PUT 및 DELETE 요청 지원
상태, 헤더, 본문을 포함한 자세한 응답 정보
사용자 정의 헤더:
- HEADER_* 환경 변수를 통한 글로벌 헤더
- 대소문자를 구분하지 않는 접두사(HEADER_, header_, HeAdEr_)
- 헤더 이름의 대소문자 유지
- 우선순위 기반 애플리케이션(요청당 > 인증 > 사용자 지정)
POST/PUT 메서드에 대한 요청 본문 처리
응답 크기 관리:
- 자동 응답 크기 제한(기본값: 10KB/10000바이트)
- REST_RESPONSE_SIZE_LIMIT 환경 변수를 통해 구성 가능한 크기 제한
- 응답이 한도를 초과하면 잘림 메타데이터를 지웁니다.
- 본문 내용만 잘라내면서 응답 구조를 유지합니다.
SSL 인증서 확인:
- 보안 작동을 위해 기본적으로 활성화됨
- 자체 서명 인증서 또는 개발 환경에서는 비활성화할 수 있습니다.
- REST_ENABLE_SSL_VERIFY 환경 변수를 통한 제어
다양한 인증 방법:
- 기본 인증(사용자 이름/비밀번호)
- 베어러 토큰 인증
- API 키 인증(사용자 정의 헤더)

사용 예

설치 및 구성이 완료되면 Cline을 통해 REST API 테스터를 사용하여 API 엔드포인트를 테스트할 수 있습니다.

// Test a GET endpoint
use_mcp_tool('rest-api', 'test_request', {
  "method": "GET",
  "endpoint": "/users"
});

// Test a POST endpoint with body
use_mcp_tool('rest-api', 'test_request', {
  "method": "POST",
  "endpoint": "/users",
  "body": {
    "name": "John Doe",
    "email": "john@example.com"
  }
});

// Test with custom headers
use_mcp_tool('rest-api', 'test_request', {
  "method": "GET",
  "endpoint": "/products",
  "headers": {
    "Accept-Language": "en-US",
    "X-Custom-Header": "custom-value"
  }
});

개발

저장소를 복제합니다.

git clone https://github.com/zenturacp/mcp-rest-api.git
cd mcp-rest-api

종속성 설치:

npm install

프로젝트를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

test_request

Related MCP Servers

OpenAPI Client Generator MCP
orhanveli
A
security
A
license
A
quality
A TypeScript-based MCP server that generates API clients from OpenAPI specifications, allowing automated code generation through natural language.
Last updated -
1
64
JavaScript
MIT License
QASE MCP Server
rikuson
A
security
A
license
A
quality
A TypeScript-based MCP server that provides integration with the Qase test management platform, allowing you to manage projects, test cases, runs, results, plans, suites, and shared steps.
Last updated -
26
4
JavaScript
MIT License
MCPKit
ribeirogab
-
security
F
license
-
quality
A simple TypeScript library for creating Model Context Protocol (MCP) servers with features like type safety, parameter validation, and a minimal code API.
Last updated -
1
TypeScript
MIT License
MCP-Typescribe
yWorks
-
security
A
license
-
quality
An MCP server that enables LLMs to understand and work with TypeScript APIs they haven't been trained on by providing structured access to TypeScript type definitions and documentation.
Last updated -
41
24
TypeScript
MIT License

View all related MCP servers

mcp-rest-api

MCP REST API 테스터

설치

Smithery를 통해 설치

수동 설치

윈도우

맥OS

특징

사용 예

개발

특허

Tools

Related MCP Servers

OpenAPI Client Generator MCP

QASE MCP Server

MCPKit

MCP-Typescribe

Appeared in Searches

New MCP Servers

MCP directory API