Registry / testing / dkmaker-mcp-rest-api

dkmaker-mcp-rest-api

library0.4.0jsnpmunverified

A TypeScript-based MCP server for testing REST API endpoints through Cline and other MCP clients. Version 0.4.0 supports GET, POST, PUT, DELETE methods with authentication (Basic, Bearer, API Key), automatic endpoint normalization, SSL verification control, and configurable response size limits. Unlike generic HTTP tools, it integrates directly with MCP ecosystems like Cline and Claude Desktop, providing structured resources for examples, response formats, and configuration. Released under MIT license, with active development on GitHub.

testing devops

npm install dkmaker-mcp-rest-api

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · DKMAKER-MCP-REST-A

dkmaker-mcp-rest-api

testingjavascriptv0.4.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

test_request

✓ import { test_request } from 'dkmaker-mcp-rest-api'

✗ const test_request = require('dkmaker-mcp-rest-api').test_request

ESM-only package; use dynamic import or top-level await in CommonJS.

Server

✓ import { Server } from 'dkmaker-mcp-rest-api'

✗ import { McpServer } from 'dkmaker-mcp-rest-api'

The exported class is named 'Server', not 'McpServer'.

REST_BASE_URL

✓ process.env.REST_BASE_URL

✗ import { REST_BASE_URL } from 'dkmaker-mcp-rest-api'

Configuration is via environment variables, not imports.

resources (examples, response-format, config)

✓ // Access via MCP client's resource requests, e.g., 'examples'

✗ import { examples } from 'dkmaker-mcp-rest-api'

Resources are served dynamically at runtime, not exported from the package.

Demonstrates installing globally, configuring environment variables for base URL and Bearer token, starting the server, and calling the test_request tool with a GET request.

# Install the package globally npm install -g dkmaker-mcp-rest-api # Set required environment variables export REST_BASE_URL="https://api.example.com" export AUTH_BEARER="your-token" # Start the server node $(npm root -g)/dkmaker-mcp-rest-api/build/index.js # In your MCP client (e.g., Cline), call the tool: # test_request({ # method: "GET", # path: "/users", # headers: { "Custom-Header": "value" }, # queryParams: { limit: "10" } # })

Debug

Known issues

breakngOn Windows, you must use full paths in cline_mcp_settings.json due to issue #40 with %APPDATA% resolution. The package will fail to start if using %APPDATA%.

fix

Use absolute path like C:/Users/<Username>/AppData/Roaming/...

affects: <=0.4.0

gotchaThe server does not start unless REST_BASE_URL is set in environment. Missing this causes immediate startup failure.

fix

Set REST_BASE_URL environment variable before starting the server.

affects: >=0.1.0

gotchaSSL verification is enabled by default; self-signed certificates will cause requests to fail.

fix

Set REST_ENABLE_SSL_VERIFY=false in environment to disable SSL verification.

affects: >=0.1.0

gotchaResponse size limit defaults to 10000 bytes. Larger responses are truncated without warning.

fix

Set REST_RESPONSE_SIZE_LIMIT to a higher value in environment.

affects: >=0.1.0

deprecatedThe package recommends installing globally (-g) but this is not standard for MCP servers; may cause version conflicts.

fix

Consider using npx or project-local install instead.

affects: >=0.1.0

Errors

Common errors & fixes

Error: Cannot find module 'dkmaker-mcp-rest-api'

Package not installed globally or local node_modules missing.

fix

Run 'npm install -g dkmaker-mcp-rest-api' or install locally with 'npm install dkmaker-mcp-rest-api'.

Error: REST_BASE_URL environment variable is required

Missing REST_BASE_URL in process environment.

fix

Set REST_BASE_URL in your shell or cline_mcp_settings.json env block.

Error: self-signed certificate in certificate chain

SSL verification enabled but API uses self-signed cert.

fix

Set REST_ENABLE_SSL_VERIFY=false in environment.

Upgrade

Version history

0.4.0latest on npm

Audit

Dependencies

@modelcontextprotocol/sdkrequiredCore dependency for MCP server implementation

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/dkmaker/mcp-rest-api ↗

packagedkmaker-mcp-rest-api ↗

homepagehttps://github.com/dkmaker/mcp-rest-api#readme ↗