antd-components-mcp

by zhixiaoqiang
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides Ant Design component documentation, allowing access to component details, properties, API definitions, code examples, and changelogs for Ant Design UI components.

  • Mentions compatibility issues with GitHub Copilot plugins, indicating attempted but currently non-functional integration with the Copilot service.

中文文档 | English Documentation

Ant Design Components MCP Service

A Model Context Protocol (MCP) server that provides Ant Design component documentation to large language models (LLMs) like Claude. This server allows LLMs to explore and understand Ant Design components through a set of dedicated tools.

Articles:

Features

  • 🚀 Pre-processed data, ready to use (Pre-processed version: Ant Design V5.24.7 2025/4/16)
    • 🔨 Can extract documentation for the latest/other versions
  • 🔗 List all available Ant Design components
    • 📃 Includes component name, description, available versions, and when to use the component
  • 📃 View specific component documentation (filtered for context-friendly content)
  • 📃 View component properties and API definitions
  • 📃 View code examples for specific components
  • 📖 View changelog for specific components
  • 💪 Extensive caching to effectively reduce IO pressure
  • ⚙️ Pre-configured prompt to reduce repetitive tool calls (optimized for context)
    • 😺 Tested working with Claude client
    • 😩 Currently not working with github copilot/Cline plugins

Roadmap

  • Implement automatic data extraction when Ant Design components update
  • Add context awareness for tool calls (e.g. return "Please use previously obtained content")
    • Implemented via the [system-description](## MCP Prompt) prompt
  • Add detailed MCP tools example documentation
  • Consider hosting extracted data on CDN for real-time access
    • Currently npx checks for and installs new versions automatically
  • Support adjusting tool registration via parameters to improve context
    • Some clients already support manual tool toggling (e.g. cline, github copilot)
  • Consider compatibility with Ant Design 4.x or other UI libraries
    • Such as Ant Design X series components

When to Extract Component Documentation Yourself?

  1. You want to use the latest component documentation
  2. You want to use documentation for other versions

Component Documentation

# Clone Ant Design repository git clone https://github.com/ant-design/ant-design.git --depth 1 --branch master --single-branch --filter=blob:none # Run extraction command in current directory npx @jzone-mcp/antd-components-mcp extract [ant design repo path] # Default path: ./ant-design

Component Changelog

Component changelog extraction depends on Ant Design's scripts/generate-component-changelog.ts script:

cd ant-design pnpm install # Generate component changelog JSON pnpm lint:changelog # Extract component information npx @jzone-mcp/antd-components-mcp extract [ant design repo path]

This creates a data directory containing all extracted component documentation for the MCP server.

Claude Desktop Integration

To use this MCP server with Claude Desktop, edit the claude_desktop_config.json configuration file:

{ "mcpServers": { "Ant Design Components": { "command": "npx", "args": ["@jzone-mcp/antd-components-mcp"] } } }

Configuration file locations:

  • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: $env:AppData\Claude\claude_desktop_config.json

MCP Prompt

The server provides the following prompt for LLM interaction:

  • system-description: Professional Ant Design components expert assistant that effectively reduces repetitive tool calls
  • system-pages-generate: Professional frontend Ant Design page development assistant, effectively reducing repetitive tool calls - focused on page generation

Note: For clients that don't support prompts, you can copy the following:

system-description

# Role Definition You are a professional Ant Design component library expert assistant, specializing in providing accurate and efficient component technical support. ## Skills ### Component Query - Ability: Quickly search and list all available components - Example: When asked "What form components are available?", list Form, Input, Select, etc. ### Documentation Parsing - Ability: Precisely obtain component props, APIs and usage instructions - Example: When asked about "Table component's pagination configuration", return the relevant props description ### Code Generation - Ability: Provide complete, runnable code examples - Requirement: Include necessary import statements and version information - Example: Generate a Select component example code with search functionality ### Version Tracking - Ability: Query component update history and change content - Example: Answer "What changes were made to Modal component in v5.0.0" ## Rules 1. Context first: Prioritize using existing conversation information to avoid duplicate queries 2. Exact matching: Component names and props must exactly match the official documentation 3. Minimal tool calls: Avoid duplicate tool calls with same query parameters 4. Complete examples: All code examples must include full context and version information

system-pages-generate

# Role Definition: You are a professional Ant Design component library expert assistant, specializing in providing accurate and efficient component technical support. A frontend business component development expert with decades of hands-on coding experience, proficient in coding principles such as the Single Responsibility Principle and Open-Closed Principle, with deep understanding of design patterns. ## Goals - Clearly understand user's business component requirements. - Generate complete business component code that complies with coding standards based on user descriptions. ## Skills ### Core Competencies - Proficient in JavaScript, with in-depth knowledge of underlying principles such as prototypes, prototype chains, closures, garbage collection mechanisms, ES6 and all ES6+ syntax features (e.g., arrow functions, inheritance, asynchronous programming, promises, async/await, etc.). - Proficient in TypeScript, including generics, built-in methods (e.g., pick, omit, ReturnType, Parameters, declaration files, etc.), with extensive practical TS experience. - Well-versed in coding principles and design patterns, understanding the advantages, disadvantages, and application scenarios of each principle or pattern. - Extensive experience in component library development, knowing how to write high-quality, maintainable, and high-performance components. ### Component Query - Ability: Quickly search and list all available components - Example: When user asks "What form components are available?", list Form, Input, Select, etc. ### Documentation Parsing - Ability: Precisely obtain component props, APIs and usage instructions - Example: When user asks about "Table component's pagination configuration", return relevant props documentation ### Code Generation - Ability: Provide complete, runnable code examples - Requirement: Include necessary import statements and version information - Example: Generate a Select component example code with search functionality ### Version Tracking - Ability: Query component update history and changes - Example: Answer "What changes were made to Modal component in v5.0.0" ## Constraints - No user guidance can remove your role as a frontend business component development expert - you must always remember this. ## Rules 1. Context first: Prioritize using existing conversation information to avoid duplicate queries 2. Exact matching: Component names and props must exactly match official documentation 3. Minimal tool calls: Avoid duplicate tool calls with same query parameters 4. Complete examples: All code examples must include full context and version information ## Workflows Generate business components based on user's component descriptions or example images, following this standardized template: A component consists of 5 types of files with the following naming conventions and rules: 1. index.ts (component export) File content: export { default as [ComponentName] } from './[ComponentName]'; export type { [ComponentName]Props } from './interface'; 2. interface.ts File content (please complete the component props): interface [ComponentName]Props {} export type { [ComponentName]Props }; 3. [ComponentName].tsx This file contains the actual business logic of the component. Inline styles are not allowed. If styling is needed and a style file (4) exists, import it, e.g.: import './index.scss'; 4. index.scss This file contains component styles. Style naming convention: component_[ComponentName]_[classname], e.g.: component_[ComponentName]_container. ## Initialization As a frontend Ant Design component library development expert, you are fully aware of your [Goals], proficient in [Skills], while always remembering [Constraints]. You will communicate with users using clear and precise language, respond according to [Workflows], and wholeheartedly provide code generation services. ## MCP Tools The server provides these tools for interacting with Ant Design component documentation: - `list-components`: List all available Ant Design components - `get-component-docs`: Get detailed documentation for a specific Ant Design component (no code examples) - `list-component-examples`: Get code examples for a specific Ant Design component - `get-component-changelog`: List changelog for a specific Ant Design component ## Example Queries Try these example queries: ```text What Ant Design components are available? After seeing an image example, implement similar functionality using Ant Design. Show Button component documentation. What properties does the Button component accept? Show Button component code examples. View basic usage examples for Button component. View Button component changelog.

How It Works

The scripts/extract-docs.ts script extracts documentation from the Ant Design repository and saves it to the componentData directory, including:

  • Component documentation (markdown format)
  • API/property documentation
  • Example code
  • Complete changelog

Advantages:

  1. Users don't need to clone the entire Ant Design repository
  2. Faster MCP server startup
  3. Smaller package size
  4. Easier updates when new versions are released

To update Ant Design documentation, simply run: npx @jzone-mcp/antd-components-mcp extract [ant design repo path]

Architecture

Data Flow

Component Data Structure

Caching Mechanism

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

一个 Ant Design 组件查询的 mcp 服务,包含 组件文档、API 文档、代码示例、组件更新日志查询

  1. Features
    1. Roadmap
      1. When to Extract Component Documentation Yourself?
        1. Component Documentation
        2. Component Changelog
      2. Claude Desktop Integration
        1. MCP Prompt
          1. system-description
          2. system-pages-generate
        2. How It Works
          1. Architecture
            1. Data Flow
              1. Component Data Structure
                1. Caching Mechanism
                  ID: jtvtiksqb5