JUHE API Marketplace
hongaah avatar
MCP Server

Swiftcode MCP Server

A Model Context Protocol server that automates code generation for web development, specializing in creating TypeScript API clients from Swagger/OpenAPI specs and Vue.js components for frontend development.

0
GitHub Stars
8/23/2025
Last Updated
No Configuration
Please check the documentation below.

README Documentation

Swiftcode MCP Server

English | 简体中文

Introduction

Swiftcode MCP Server is a server based on the Model Context Protocol (MCP), focusing on automated code generation to support modern web development workflows. It can automatically generate TypeScript API clients from Swagger/OpenAPI specifications and quickly generate Vue list page components based on templates, greatly improving frontend and backend development efficiency.

Swiftcode Server MCP server

Features

  • Swagger/OpenAPI to TypeScript: Automatically generate TypeScript API clients and type definitions.
  • Vue Component Generation: One-click generation of Vue 3 list pages with tables, filters, and pagination.
  • Template Management: Obtain and use built-in code generation templates.
  • Specification Validation: Supports Swagger/OpenAPI validation.
  • Mock Data Generation: Optionally generate mock data for frontend development.

Supported Technologies

  • Frontend: Vue 3 (Composition API), Element Plus, TypeScript
  • API Specification: Swagger 2.0, OpenAPI 3.0+ (JSON/YAML)
  • Code Generation: TypeScript interfaces/types, Vue 3 components, Element Plus forms and tables

Tool List

1. generate_api_client

Generate TypeScript API client from Swagger/OpenAPI specification.

Parameters:

  • source (string): Swagger/OpenAPI file path or URL
  • dir (string): Output directory

Example:

{
  "source": "/mock/swagger.json",
  "dir": "./"
}

2. generate_sfc_template_client

Download and generate SFC/Vue list template files to the specified directory.

Parameters:

  • dir (string): Output directory

Example:

{
  "dir": "./"
}

3. generate_sfc_client

Generate Vue list components based on template files.

Parameters:

  • source (string): Template file path
  • dir (string): Output directory

Example:

{
  "source": "template.js",
  "dir": "./"
}

Quick Start

NPX (Recommended)

Start as an MCP Server:

{
  "mcpServers": {
    "swiftcode-npm": {
      "command": "npx",
      "args": ["-y", "@swiftcode/mcp"]
    }
  }
}

Local Development

pnpm install

# Build MCP
pnpm build

# Start MCP inspector
pnpm inspector

Start as an MCP Server:

{
  "mcpServers": {
    // Local development
    "swiftcode-local": {
      "command": "node",
      "args": ["swiftcode-mcp-server/dist/index.js"]
    }
  }
}

Docker

docker build -t swiftcode-mcp .
docker run -it swiftcode-mcp

Usage Examples

Generate API Client

{
  "source": "/user/swagger.json",
  "dir": "./"
}

Generate Vue List Component

{
  "source": "template.js",
  "dir": "./"
}

Contribution Guide

  1. Fork this repository
  2. Create a feature branch
  3. Commit your changes
  4. Add tests if necessary
  5. Submit a Pull Request

License

MIT


For more help or questions, please visit the GitHub.

Quick Actions

Key Features

Model Context Protocol
Secure Communication
Real-time Updates
Open Source