dkmaker/mcp-rest-api

A TypeScript-based MCP server that enables testing of REST APIs through Claude, Cline and other MCP clients. This tool allows you to test and interact with any REST API endpoints directly from your development environment.
## Installation
Install the package globally:
bash
npm install -g dkmaker-mcp-rest-api
## Configuration
### Cline Custom Instructions
To ensure Cline understands how to effectively use this tool, add the following to your Cline custom instructions (Settings > Custom Instructions):
markdown
# REST API Testing Instructions
The testrequest 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, PATCH 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 Server Configuration
While these instructions are for Cline, the server should work with any MCP implementation. Configure based on your operating system:
### Windows
⚠️ IMPORTANT: Due to a known issue with Windows path resolution (issue #40), you must use the full path instead of %APPDATA%.
Add to C:\Users\ \AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\clinemcpsettings.json:
json
"mcpServers": {
"rest-api": {
"command": "node",
"args": [
"C:/Users/ /AppData/Roaming/npm/nodemodules/dkmaker-mcp-rest-api/build/index.js"
],
"env": {
"RESTBASEURL": "https://api.example.com",
// Basic Auth
"AUTHBASICUSERNAME": "your-username",
"AUTHBASICPASSWORD": "your-password",
// OR Bearer Token
"AUTHBEARER": "your-token",
// OR API Key
"AUTHAPIKEYHEADERNAME": "X-API-Key",
"AUTHAPIKEYVALUE": "your-api-key",
// SSL Verification (enabled by default)
"RESTENABLESSLVERIFY": "false", // Set to false to disable SSL verification for self-signed certificates
// Response Size Limit (optional, defaults to 10000 bytes)
"RESTRESPONSESIZELIMIT": "10000", // Maximum response size in bytes
// Custom Headers (optional)
"HEADERX-API-Version": "2.0",
"HEADERCustom-Client": "my-client",
"HEADERAccept": "application/json"
### macOS
Add to ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/clinemcpsettings.json:
json
"mcpServers": {
"rest-api": {
"command": "npx",
"args": [
"-y",
"dkmaker-mcp-rest-api"
],
"env": {
"RESTBASEURL": "https://api.example.com",