Skip to main content
Glama
liliangshan

mcp-server-apidebug

by liliangshan

mcp-server-apidebug

English | 中文


English

Servidor MCP para depuración de API

Un servidor MCP (Model Context Protocol) independiente para depuración de API, autenticación de inicio de sesión, gestión de configuración de API y ejecución de API indexada.

Características

  • api_config: Gestiona la configuración de depuración de API, URL base, encabezados comunes y lista de API

  • api_debug: Ejecuta solicitudes de API directamente, admite métodos GET/POST/PUT/DELETE/PATCH, parámetros de consulta, encabezados, cuerpo y detección automática de Content-Type

  • api_execute: Ejecuta solicitudes por índice guardado en api_config

  • api_login: Ejecuta solicitudes de inicio de sesión basadas en variables de entorno

  • api_help: Consulta la documentación y ejemplos de las herramientas de depuración de API

Instalación

Instalación global (recomendado):

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

Instalación local:

npm install @liangshanli/mcp-server-apidebug

Desarrollo local

npm start

O inicie el servidor directamente:

node src/server.js

Autoprueba rápida

npm test

Esto mostrará el resultado de tools/list de MCP.

Variables de entorno

Variable

Predeterminado

Descripción

PROJECT_PATH

.

Directorio del proyecto; utiliza el directorio actual cuando no está configurado

TOOL_PREFIX

default

Prefijo del nombre de la herramienta; las herramientas predeterminadas son default_api_debug, default_api_config, etc.

CONFIG_DIR

vacío

Anulación opcional del directorio de configuración; generalmente no es necesario. Cuando no está configurado, utiliza PROJECT_PATH/.setting/{TOOL_PREFIX}

API_DEBUG_BASE_URL

vacío

URL base de la API; cuando está configurado, no es necesario establecer baseUrl a través de api_config

API_DEBUG_ALLOWED_METHODS

GET,POST,PUT,DELETE,PATCH

Métodos HTTP permitidos, separados por comas

API_DEBUG_LOGIN_URL

/api/login

URL de la API de inicio de sesión

API_DEBUG_LOGIN_METHOD

POST

Método de la API de inicio de sesión

API_DEBUG_LOGIN_BODY

{"username":"","password":""}

Cuerpo de la solicitud de inicio de sesión, admite cadena JSON o cadena simple

API_DEBUG_LOGIN_DESCRIPTION

vacío

Descripción de la herramienta de inicio de sesión

API_DEBUG_LOGIN_USER_HEADER

new-api-user

Nombre del encabezado para el ID de usuario (extraído de la respuesta de inicio de sesión)

Ejemplo de configuración de 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": "Execute login requests based on environment variables. Use api_config interface to handle login configuration after successful login."
      }
    }
  }
}

Almacenamiento de configuración

Ruta de almacenamiento predeterminada:

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

Si PROJECT_PATH no está configurado, el valor predeterminado es .; si TOOL_PREFIX no está configurado, el valor predeterminado es default.

Ejemplos de uso

  1. Establecer URL base:

{
  "action": "updateBaseUrl",
  "baseUrl": "https://api.example.com"
}
  1. Depurar una API:

{
  "url": "/api/users",
  "method": "GET",
  "query": {
    "page": 1,
    "limit": 10
  }
}
  1. Agregar una API y ejecutar por índice:

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

Related MCP server: Postmancer

中文

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_debugdefault_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

使用示例

  1. 设置 Base URL:

{
  "action": "updateBaseUrl",
  "baseUrl": "https://api.example.com"
}
  1. 调试接口:

{
  "url": "/api/users",
  "method": "GET",
  "query": {
    "page": 1,
    "limit": 10
  }
}
  1. 添加接口后按索引执行:

{
  "action": "addApi",
  "api": {
    "url": "/api/login",
    "method": "POST",
    "body": {
      "username": "admin",
      "password": "123456"
    }
  }
}
{
  "index": 0
}
Install Server
A
license - permissive license
A
quality
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A standalone MCP server for API testing and management, allowing AI assistants to interact with RESTful APIs through natural language.
    13
    28
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    MCP server for making API calls with authentication support. Allows configuring multiple API endpoints and performing GET, POST, PUT, DELETE requests, including form data and file uploads.

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/liliangshan/mcp-server-apidebug'

If you have feedback or need assistance with the MCP directory API, please join our Discord server