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.
Latest Blog Posts
- 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