mcp-server-apidebug

English | 中文

English

MCP Server for API Debugging

A standalone MCP (Model Context Protocol) server for API debugging, login authentication, API configuration management, and indexed API execution.

Features

api_config: Manage API debugging configuration, Base URL, common Headers, and API list
api_debug: Execute API requests directly, supports GET/POST/PUT/DELETE/PATCH methods, query parameters, headers, body, automatic Content-Type detection
api_execute: Execute requests by index saved in api_config
api_login: Execute login requests based on environment variables
api_help: View API debugging tool documentation and examples

Installation

Global installation (Recommended):

npm install -g @liangshanli/mcp-server-apidebug

Local installation:

npm install @liangshanli/mcp-server-apidebug

Local Development

npm start

Or start the server directly:

node src/server.js

Quick Self-Test

npm test

This will output the MCP tools/list result.

Environment Variables

Variable	Default	Description
`PROJECT_PATH`	`.`	Project directory; uses current directory when not set
`TOOL_PREFIX`	`default`	Tool name prefix; default tools are `default_api_debug`, `default_api_config`, etc.
`CONFIG_DIR`	empty	Optional config directory override; generally not needed. When not set, uses `PROJECT_PATH/.setting/{TOOL_PREFIX}`
`API_DEBUG_BASE_URL`	empty	API base URL; when configured, no need to set `baseUrl` via `api_config`
`API_DEBUG_ALLOWED_METHODS`	`GET,POST,PUT,DELETE,PATCH`	Allowed HTTP methods, comma-separated
`API_DEBUG_LOGIN_URL`	`/api/login`	Login API URL
`API_DEBUG_LOGIN_METHOD`	`POST`	Login API method
`API_DEBUG_LOGIN_BODY`	`{"username":"","password":""}`	Login request body, supports JSON string or plain string
`API_DEBUG_LOGIN_DESCRIPTION`	empty	Login tool description
`API_DEBUG_LOGIN_USER_HEADER`	`new-api-user`	Header name for user ID (extracted from login response)

MCP Configuration Example

{
  "servers": {
    "apidebug": {
      "command": "npx",
      "args": [
        "@liangshanli/mcp-server-apidebug"
      ],
      "env": {
        "API_DEBUG_BASE_URL": "https://api.example.com",
        "API_DEBUG_ALLOWED_METHODS": "GET,POST,PUT,DELETE,PATCH",
        "API_DEBUG_LOGIN_URL": "/api/user/login",
        "API_DEBUG_LOGIN_METHOD": "POST",
        "API_DEBUG_LOGIN_BODY": "{\"username\":\"your_username\",\"password\":\"your_password\"}",
        "API_DEBUG_LOGIN_USER_HEADER": "new-api-user",
        "API_DEBUG_LOGIN_DESCRIPTION": "Execute login requests based on environment variables. Use api_config interface to handle login configuration after successful login."
      }
    }
  }
}

Configuration Storage

Default storage path:

{PROJECT_PATH}/.setting/{TOOL_PREFIX}/api.json

If PROJECT_PATH is not set, defaults to .; if TOOL_PREFIX is not set, defaults to default.

Usage Examples

Set Base URL:

{
  "action": "updateBaseUrl",
  "baseUrl": "https://api.example.com"
}

Debug an API:

{
  "url": "/api/users",
  "method": "GET",
  "query": {
    "page": 1,
    "limit": 10
  }
}

Add an API and execute by index:

{
  "action": "addApi",
  "api": {
    "url": "/api/login",
    "method": "POST",
    "body": {
      "username": "admin",
      "password": "123456"
    }
  }
}

{
  "index": 0
}

中文

API 调试 MCP 服务器

独立运行的 MCP (Model Context Protocol) 服务器，用于 API 调试、登录认证、API 配置管理和按索引执行 API 请求。

工具列表

api_config：管理 API 调试配置、Base URL、公共 Headers 和接口列表
api_debug：直接执行 API 请求，支持 GET/POST/PUT/DELETE/PATCH 方法、query 参数、headers、body，自动检测 Content-Type
api_execute：按 api_config 中保存的接口索引执行请求
api_login：根据环境变量执行登录请求
api_help：查看 API 调试工具说明和示例

安装依赖

全局安装（推荐）：

npm install -g @liangshanli/mcp-server-apidebug

本地安装：

npm install @liangshanli/mcp-server-apidebug

本地运行

npm start

或直接启动 server：

node src/server.js

快速自检

npm test

会输出 MCP tools/list 结果。

环境变量

变量	默认值	说明
`PROJECT_PATH`	`.`	项目目录；不设置时使用当前目录
`TOOL_PREFIX`	`default`	工具名前缀；默认工具名为 `default_api_debug`、`default_api_config` 等
`CONFIG_DIR`	空	可选覆盖配置目录；一般不需要设置。未设置时使用 `PROJECT_PATH/.setting/{TOOL_PREFIX}`
`API_DEBUG_BASE_URL`	空	API 基础 URL；配置后无需再通过 `api_config` 设置 `baseUrl`
`API_DEBUG_ALLOWED_METHODS`	`GET,POST,PUT,DELETE,PATCH`	允许执行的 HTTP 方法，逗号分隔
`API_DEBUG_LOGIN_URL`	`/api/login`	登录接口 URL
`API_DEBUG_LOGIN_METHOD`	`POST`	登录接口方法
`API_DEBUG_LOGIN_BODY`	`{"username":"","password":""}`	登录请求体，支持 JSON 字符串或普通字符串
`API_DEBUG_LOGIN_DESCRIPTION`	空	登录工具说明
`API_DEBUG_LOGIN_USER_HEADER`	`new-api-user`	用户 ID 的 Header 名称（从登录响应中提取）

MCP 配置示例

{
  "servers": {
    "apidebug": {
      "command": "npx",
      "args": [
        "@liangshanli/mcp-server-apidebug"
      ],
      "env": {
        "API_DEBUG_BASE_URL": "https://api.example.com",
        "API_DEBUG_ALLOWED_METHODS": "GET,POST,PUT,DELETE,PATCH",
        "API_DEBUG_LOGIN_URL": "/api/user/login",
        "API_DEBUG_LOGIN_METHOD": "POST",
        "API_DEBUG_LOGIN_BODY": "{\"username\":\"your_username\",\"password\":\"your_password\"}",
        "API_DEBUG_LOGIN_USER_HEADER": "new-api-user",
        "API_DEBUG_LOGIN_DESCRIPTION": "根据环境变量执行登录请求。使用 api_config 接口处理登录成功后的配置。"
      }
    }
  }
}

配置保存路径

默认保存目录规则：

{PROJECT_PATH}/.setting/{TOOL_PREFIX}/api.json

如果 PROJECT_PATH 不设置，则默认 .；如果 TOOL_PREFIX 不设置，则默认 default。

使用示例

设置 Base URL：

{
  "action": "updateBaseUrl",
  "baseUrl": "https://api.example.com"
}

调试接口：

{
  "url": "/api/users",
  "method": "GET",
  "query": {
    "page": 1,
    "limit": 10
  }
}

添加接口后按索引执行：

{
  "action": "addApi",
  "api": {
    "url": "/api/login",
    "method": "POST",
    "body": {
      "username": "admin",
      "password": "123456"
    }
  }
}

{
  "index": 0
}

mcp-server-apidebug