MCP API Toolkit

🚀 MCP API工具包

全面的API开发和测试用于Claude Code的MCP服务器

  

MCP API工具包 通过模型上下文协议为Claude Code带来强大的API开发能力。想想Postman+OpenAPI+人工智能驱动的测试，所有这些都集成到您的Claude工作流程中。

✨ 特性

• 🔍 OpenAPI/Swagger解析 -导入并验证API规范
• 🧪 API测试 -使用人工智能见解执行和验证API请求
• 📚 文档生成 -自动生成漂亮的API文档
• 🛠️ SDK生成 -自动创建TypeScript、Python、JavaScript SDK
• 🎭 模拟数据 -从模式生成真实的测试数据
• ⚡ 批量测试 -一次测试多个端点
• 🔒 请求验证 -确保请求/响应与模式匹配
• 📊 性能洞察 -跟踪响应时间和大小

📦 安装

NPM（推荐）

npm install -g mcp-api-toolkit

来源

git clone https://github.com/yourusername/mcp-api-toolkit.git
cd mcp-api-toolkit
npm install
npm run build
npm link

🔧 配置

添加到您的Claude Code MCP设置中：

macOS/Linux： ~/Library/Application Support/Claude/claude_desktop_config.json

窗户： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "api-toolkit": {
      "command": "mcp-api-toolkit"
    }
  }
}

或者使用npx：

{
  "mcpServers": {
    "api-toolkit": {
      "command": "npx",
      "args": ["-y", "mcp-api-toolkit"]
    }
  }
}

重新启动Claude Code以激活MCP服务器。

🎯 用法

1.解析OpenAPI规范

Parse this OpenAPI spec: https://api.example.com/openapi.json

或者直接粘贴规范：

Parse this OpenAPI spec:
{
  "openapi": "3.0.0",
  "info": { "title": "My API", "version": "1.0.0" },
  ...
}

2.列出API终点

List all endpoints from the parsed spec

3.测试端点

Test the GET /users endpoint with authentication header

克劳德将使用 test_api_endpoint 工具：

GET https://api.example.com/users
Headers: { "Authorization": "Bearer token" }

4.生成SDK

Generate a TypeScript SDK from the parsed spec

Claude将创建一个完全类型化的客户端库：

export class MyAPIClient {
  async getUsers(config?: RequestConfig): Promise {
    // Auto-generated implementation
  }
}

5.生成文档

Generate markdown documentation for this API

6.创建模拟数据

Generate 5 mock user objects based on this schema:
{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "email": { "type": "string" },
    "age": { "type": "number" }
  }
}

🛠️ 可用工具

parse_openapi

解析并验证OpenAPI/Swagger规范（JSON、YAML或URL）。

输入：

• input （string）：OpenAPI规范为JSON/YAML或URL
• isUrl （boolean）：输入是否为URL

输出： 解析后的规范及其摘要

list_endpoints

从规范中提取所有API端点。

输入：

• spec （字符串）：OpenAPI规范JSON
• filterByTag （字符串，可选）：按标签筛选
• filterByMethod （字符串，可选）：按HTTP方法筛选

输出： 带有方法和路径的端点列表

test_api_endpoint

执行并验证API请求。

输入：

• method （string）：HTTP方法（GET、POST、PUT、PATCH、DELETE）
• url （string）：要测试的完整URL
• headers （对象，可选）：HTTP标头
• body （object，可选）：请求正文
• params （对象，可选）：查询参数
• expectedStatus （数字，可选）：预期的HTTP状态
• timeout （数字，可选）：超时（毫秒）（默认值：30000）

输出： 响应数据、状态、时间、验证结果

generate_sdk

生成多种语言的客户端SDK。

输入：

• spec （字符串）：OpenAPI规范JSON
• language （字符串）：typescript|python|javascript|go
• clientName （字符串，可选）：自定义客户端类名

输出： 生成的SDK代码

generate_mock_data

从JSON模式创建模拟数据。

输入：

• schema （对象）：JSON模式定义
• count （number，可选）：要生成的对象数量

输出： 模拟数据对象数组

generate_api_docs

根据OpenAPI规范生成markdown文档。

输入：

• spec （字符串）：OpenAPI规范JSON
• includeExamples （布尔值，可选）：包括示例（默认值：true）

输出： Markdown文档

validate_api_response

根据架构验证响应。

输入：

• response （对象）：API响应数据
• schema （对象）：预期架构

输出： 验证结果

batch_test_endpoints

一次测试多个端点。

输入：

• spec （字符串）：OpenAPI规范JSON
• baseUrl （字符串，可选）：覆盖基本URL
• filterByTag （字符串，可选）：仅测试标记的端点
• headers （对象，可选）：常用标题

输出： 批量测试结果总结

📖 示例

示例1：测试公共API

Parse the JSONPlaceholder API: https://jsonplaceholder.typicode.com/

Then test the GET /posts/1 endpoint

示例2：生成客户端库

Parse this OpenAPI spec and generate a Python SDK:

{
  "openapi": "3.0.0",
  "info": { "title": "User API", "version": "1.0.0" },
  "servers": [{ "url": "https://api.example.com" }],
  "paths": {
    "/users": {
      "get": {
        "summary": "List users",
        "responses": {
          "200": { "description": "Success" }
        }
      }
    }
  }
}

示例3：API测试工作流程

1. Parse the Stripe API spec: https://raw.githubusercontent.com/stripe/openapi/master/openapi/spec3.json
2. List all payment-related endpoints
3. Generate TypeScript SDK
4. Create mock customer data

🎨 用例

API开发

• 导入现有OpenAPI规范
• 开发过程中的测试端点
• 自动生成客户端库
• 创建API文档

API测试

• 验证API响应
• 健康检查的批量测试端点
• 使用时间度量进行性能测试
• 用于测试的模拟数据生成

API集成

• 生成SDK以便于集成
• 集成前测试第三方API
• 验证API合同
• 记录外部API

学习与探索

• 探索公共API（GitHub、Stripe、Twitter等）
• 了解API结构
• 生成工作代码示例
• 创建教育文档

🏗️ 建筑

mcp-api-toolkit/
├── src/
│   ├── index.ts           # Main MCP server
│   ├── tools/             # MCP tool definitions
│   ├── utils/
│   │   ├── openapi-parser.ts  # OpenAPI parsing
│   │   ├── api-client.ts      # HTTP client
│   │   └── sdk-generator.ts   # SDK generation
│   └── types/
│       └── api.ts         # TypeScript types
├── examples/              # Usage examples
├── docs/                  # Documentation
└── tests/                 # Unit tests

🔒 安全

• 未存储API凭据
• 所有请求都是按需提出的
• 利率限制方面
• 使用Zod进行输入验证
• HTTPS仅用于URL解析

🤝 贡献

欢迎投稿！请阅读我们的 贡献指南 第一。

1. 分叉存储库
2. 创建要素分支： git checkout -b feature/amazing-feature
3. 提交更改： git commit -m 'Add amazing feature'
4. 推送到分支： git push origin feature/amazing-feature
5. 打开拉取请求

📝 许可证

MIT许可证-请参阅 许可证 详细信息文件

🌟 明星历史

如果你觉得这个项目有用，请考虑在GitHub上给它一颗星！

🔗 链接

• 模型上下文协议
• 克劳德代码
• OpenAPI规范
• 报告问题

💡 灵感

为解决2025年API首次开发工作流程而构建。灵感来源：

• Postman直观的API测试
• OpenAPI的标准化
• Claude的人工智能开发援助

📧 支持

• 文档： docs/
• 问题：
• 讨论：

______________________________________________________________________

由以下材料制成❤️ Claude Code社区

*使用人工智能增强您的API开发工作流程！*