swagger-codegen-mcp
Generates TypeScript API client code from Swagger/OpenAPI documentation, enabling automated creation of typed API functions and interfaces.
Provides TypeScript type definitions and API functions derived from Swagger documentation, streamlining frontend development with fully typed API clients.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@swagger-codegen-mcpgenerate code for tag VillageNursing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Swagger API 代码生成器 MCP
从 Swagger/OpenAPI 文档自动生成 TypeScript API 代码的 MCP 服务器。
功能
list_services - 列出所有可用的 API 服务及其 Swagger URL
list_tags - 列出 Swagger 中所有的 API 分组(tags)
list_endpoints - 列出指定 tag 下的所有接口
get_endpoint_detail - 获取单个接口的详细信息
generate_api_code - 生成 TypeScript 代码(支持按 tag 或单个接口)
Related MCP server: Swagger MCP (Multi-API Edition)
支持的服务
MCP 服务器预配置了以下 API 服务,会根据 API 路径自动推断使用哪个服务:
服务名 | Swagger URL | 匹配路径示例 |
village |
|
|
basic |
|
|
ffp |
|
|
dynamic |
|
|
customform |
|
|
ncdp |
|
|
gis |
|
|
query |
|
|
提示:当你传入
path参数时(如/api/village/VillageNursing/GetNursingStats),服务器会自动从路径中提取village并使用对应的 swagger.json,无需手动指定swagger_url。
安装
cd C:\Users\Administrator\.gemini\mcp\swagger-codegen-mcp
npm install配置 Gemini CLI
在 settings.json 中添加此 MCP 服务器:
{
"mcpServers": {
"swagger-codegen": {
"command": "node",
"args": [
"C:\\Users\\Administrator\\.gemini\\mcp\\swagger-codegen-mcp\\src\\index.js"
]
}
}
}使用示例
1. 列出所有可用服务
list_services()返回示例:
{
"success": true,
"total": 8,
"services": [
{
"name": "village",
"url": "https://dvs-dev2.utuapp.cn/api/village/swagger.json"
},
{
"name": "basic",
"url": "https://dvs-dev2.utuapp.cn/api/basic/swagger.json"
}
],
"hint": "使用 path 参数时会自动根据路径推断服务"
}2. 列出所有 API 分组
list_tags()返回示例:
{
"success": true,
"swaggerUrl": "https://dvs-dev2.utuapp.cn/api/village/swagger.json",
"total": 50,
"tags": [
{ "name": "VillageNursing", "description": "" },
{ "name": "Accusation", "description": "" }
]
}3. 列出指定分组的接口
list_endpoints(tag: "VillageNursing")4. 获取接口详情(自动推断服务)
get_endpoint_detail(
path: "/api/village/VillageNursing/GetNursingStats",
method: "get"
)无需指定
swagger_url,会自动从 path 中提取village并使用 village 服务的 swagger.json。
5. 生成整个模块的代码
generate_api_code(tag: "VillageNursing")生成两个文件:
villagenursing.types.ts- 类型定义villagenursing.ts- API 函数
6. 生成单个接口的代码(自动推断服务)
generate_api_code(
path: "/api/basic/User/GetList",
method: "get"
)会自动使用 basic 服务的 swagger.json。
生成的代码风格
生成的代码兼容项目的 request.js 封装:
import request from "@/common/utils/request";
import type {
GetPageListParams,
VillageNursingListDto,
} from "./villagenursing.types";
/** 查询列表 */
export function getPageList(
params: GetPageListParams
): Promise<VillageNursingListDto[]> {
return request("/api/village/VillageNursing/GetPageList", {
method: "get",
params: { RegionId, Limit, Page, Keyword },
});
}配置文件
服务端点配置位于 src/swagger-config.js,可以根据需要添加更多服务:
const SWAGGER_SERVICES = {
village: `${API_BASE_URL}/village/swagger.json`,
basic: `${API_BASE_URL}/basic/swagger.json`,
// 添加更多服务...
};测试
# 运行配置测试
node test/test-config.js
# 查找模型定义
node test/find-model.jsThis server cannot be installed
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
- AlicenseBqualityDmaintenanceA server based on Model Context Protocol that parses Swagger/OpenAPI documents and generates TypeScript types and API client code for different frameworks (Axios, Fetch, React Query).Last updated121216ISC
- Alicense-qualityFmaintenanceEnables AI to interact with multiple Swagger/OpenAPI specifications by listing endpoints, exploring models, and generating TypeScript code. It centralizes the management of various APIs through a configuration file, allowing for seamless integration of documentation into AI workflows.Last updated79MIT
- Flicense-qualityDmaintenanceEnables reading and parsing Swagger/OpenAPI specifications to list API endpoints, get detailed endpoint info, search APIs, and generate TypeScript types for request/response.Last updated
- Flicense-qualityDmaintenanceEnables AI to scan and query local OpenAPI/Swagger documentation, listing API groups and endpoints, and generating TypeScript type definitions for specific endpoints.Last updated
Related MCP Connectors
Kickstart development with a customizable TypeScript template featuring sample tools for greeting,…
Deploy production REST APIs from JSON schemas in seconds. Manage projects, schemas, and deployments.
A TypeScript MCP server for Home Assistant, enabling programmatic management of entities, automati…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/aehyok/swagger-codegen-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server