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.

Related MCP server: Swagger 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.