mcpField
M
Mcp Api Tester

Mcp Api Tester

本地服务
github.com/xingonliu开发工具355 周前更新
代码仓库

关于 Mcp Api Tester

Mcp Api Tester 是一个用于测试 HTTP API 并将 JSON 响应转换为 TypeScript 接口的 MCP 服务。它面向希望在 MCP 客户端中检查请求并生成类型定义的开发者。

主要功能

  1. 01测试 HTTP 方法与 API
  2. 02配置请求头和请求体
  3. 03预览响应状态与数据
  4. 04生成 TypeScript 接口

适用场景

  1. 01开发时检查 API 响应
  2. 02根据返回的 JSON 生成类型

MCP 相关

向 MCP 客户端提供 `apiTester` 工具，用于发送 HTTP 请求并返回响应数据及生成的 TypeScript 接口。支持 stdio 和 HTTP 模式。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "api-tester": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-api-tester"
      ]
    }
  }
}
启动命令npx -y mcp-api-tester

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmmcp-api-tester

工具

1

收录的工具列表 · 更新于 3 周前

参数类型必填说明
urlstring是API 的请求地址，必须是有效的 URL
bodyany否请求体，可以是 JSON、字符串或对象，根据 method 自动处理
methodenum否HTTP 请求方法，默认为 GETGET | POST | PUT | DELETE | PATCH | HEAD | OPTIONS
headersobject否请求头，键值对形式，例如 {"Authorization": "Bearer ..."}
expectStatusinteger否期望的 HTTP 状态码，默认为 200

详细介绍

来自项目 README

MCP API Tester Server

这是一个基于 Model Context Protocol (MCP) 的 API 测试工具服务器。它可以测试任意 HTTP API 并自动生成 TypeScript 类型定义。

安装

全局安装
npm install -g mcp-api-tester
本地安装
npm install mcp-api-tester
从源码安装
git clone https://github.com/xingonliu/api-tester
cd mcp-api-tester
npm install
npm run build

使用方法

作为 npm 包使用

安装后，你可以通过以下方式运行：

# 全局安装后
mcp-api-tester

# 或者使用 npx
npx mcp-api-tester

# 本地安装后
npx mcp-api-tester
开发模式
1. HTTP模式
npm run dev

服务器将在 http://localhost:3000/mcp 运行

2. stdio模式（MCP标准方式）
npm run dev:stdio
3. 构建生产版本
npm run build
node dist/stdio-server.js

MCP客户端配置

要连接到这个服务器，在MCP客户端配置中添加：

全局安装后
{
  "mcpServers": {
    "api-tester": {
      "command": "mcp-api-tester"
    }
  }
}
本地安装或直接使用
{
  "mcpServers": {
    "api-tester": {
      "command": "node",
      "args": ["path/to/dist/stdio-server.js"]
    }
  }
}
使用 npx
{
  "mcpServers": {
    "api-tester": {
      "command": "npx",
      "args": ["mcp-api-tester"]
    }
  }
}

工具功能

apiTester 工具
  • 功能: 测试任意HTTP API并生成TypeScript类型定义
  • 输入: URL、HTTP方法、请求头、请求体等
  • 输出: API响应数据和自动生成的TypeScript接口

文件结构

├── src/
│   ├── index.ts          # HTTP服务器版本
│   ├── stdio-server.ts   # stdio服务器版本（MCP标准）
│   ├── tools/
│   │   └── apiTester.ts  # API测试工具实现
│   └── utils/
│       └── quicktypeGen.ts # TypeScript类型生成工具
├── dist/                 # 编译后的JavaScript文件
└── mcp-config.json      # MCP客户端配置示例

现在你的MCP服务器应该可以正常工作了！🎉

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。