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
- 종속성 설치:
- 프로젝트를 빌드하세요:
자동 재빌드를 사용한 개발의 경우:
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.