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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

mcp-rest-api

MCP REST API 테스터

설치

Smithery를 통해 설치

수동 설치

윈도우

맥OS

특징

사용 예

개발

특허

Tools

Appeared in Searches