# MCP Interface Validator - Интеллектуальные Ограничения Интерфейса и Валидация
[](https://github.com/xiaoxiaofeiya/mcp-interface-validator)
[](https://www.npmjs.com/package/mcp-interface-validator)
## ❌ Без MCP Interface Validator
Код фронтенда и бэкенда, сгенерированный ИИ, может иметь проблемы несогласованности интерфейса:
- ❌ Вызовы API фронтенда не соответствуют реализациям бэкенда
- ❌ Несогласованные определения структуры данных вызывают ошибки времени выполнения
- ❌ Отсутствие единых спецификаций интерфейса затрудняет командную работу
- ❌ Ручная проверка согласованности интерфейса неэффективна
## ✅ С MCP Interface Validator
MCP Interface Validator автоматически проверяет согласованность интерфейса между кодом фронтенда и бэкенда, сгенерированным ИИ, используя спецификации OpenAPI 3.0.
Добавьте `.use interface` к вашим промптам в Cursor:
```txt
Разработать систему входа пользователя с формой фронтенда и API бэкенда. .use interface
```
```txt
Создать модуль управления продуктами с операциями CRUD. .use interface
```
MCP Interface Validator будет:
- 🔍 **Интеллектуальная Инъекция Ограничений** - Автоматически добавлять ограничения валидации интерфейса к промптам ИИ
- 📋 **Валидация Спецификаций OpenAPI** - Обеспечивать соответствие сгенерированного кода спецификациям API
- 🔄 **Проверка Интерфейса в Реальном Времени** - Валидировать согласованность интерфейса фронтенд-бэкенд
- 🛠️ **Поддержка Мульти-инструментов** - Поддержка Cursor, Windsurf, Trae, Augment и других инструментов ИИ
## 🚀 Основные Функции
### Система Интеллектуальных Ограничений
- **Команда `.use interface`** - Активация ограничений валидации интерфейса одним кликом
- **Автоматическая Инъекция Промптов** - Интеллектуальное распознавание и инъекция промптов ограничений OpenAPI
- **Многоязычная Поддержка** - Поддержка команд на китайском и английском языках
- **Обработка Нечетких Инструкций** - Обработка неточных пользовательских инструкций
### Движок Валидации Интерфейса
- **Поддержка OpenAPI 3.0** - Полная валидация спецификаций Swagger
- **Валидация в Реальном Времени** - Проверка интерфейса в реальном времени во время генерации кода
- **Отчеты об Ошибках** - Подробные отчеты о несогласованности интерфейса
- **Предложения Автоисправления** - Предоставление предложений по исправлению интерфейса
### Интеграция Мульти-инструментов
- **Cursor** - Полная поддержка ИИ-помощника программирования Cursor
- **Windsurf** - Интеграция с средой разработки Windsurf
- **Trae** - Поддержка инструментов ИИ Trae
- **Augment** - Совместимость с помощником кода Augment
- **Claude Desktop** - Поддержка приложения Claude Desktop
## 🛠️ Быстрый Старт
### Требования
- Node.js >= v18.0.0
- Инструменты ИИ, поддерживающие протокол MCP (Cursor, Windsurf, Claude Desktop и т.д.)
### Глобальная Установка
```bash
npm install -g mcp-interface-validator
```
### Установка с GitHub
```bash
npm install -g https://github.com/xiaoxiaofeiya/mcp-interface-validator.git
```
## 📦 Настройка Конфигурации
### Настройка в Cursor
Добавьте следующую конфигурацию в файл `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"interface-validator": {
"command": "mcp-interface-validator",
"args": []
}
}
}
```
### Настройка в Windsurf
```json
{
"mcpServers": {
"interface-validator": {
"command": "mcp-interface-validator",
"args": []
}
}
}
```
### Настройка в Claude Desktop
Добавьте следующее в `claude_desktop_config.json`:
```json
{
"mcpServers": {
"interface-validator": {
"command": "mcp-interface-validator",
"args": []
}
}
}
```
### Настройка в VSCode
```json
{
"servers": {
"interface-validator": {
"type": "stdio",
"command": "mcp-interface-validator",
"args": []
}
}
}
```
## 🎯 Использование
### Базовое Использование
1. **Активировать Интеллектуальные Ограничения**: Добавьте `.use interface` к вашим промптам ИИ
2. **Описать Требования**: Нормально опишите ваши потребности в разработке
3. **Автоматическая Валидация**: Система автоматически инъецирует ограничения валидации интерфейса
4. **Получить Результаты**: Получите код, соответствующий спецификациям OpenAPI
### Примеры Сценариев
**Система Управления Пользователями**:
```txt
Разработать функциональность регистрации и входа пользователя с валидацией формы фронтенда и API бэкенда. .use interface
```
**Модуль Управления Продуктами**:
```txt
Создать операции CRUD продуктов, фронтенд используя React, бэкенд используя Express. .use interface
```
**Система Обработки Заказов**:
```txt
Реализовать функции создания, запроса и обновления заказов, обеспечивая согласованность структуры данных фронтенд-бэкенд. .use interface
```
## 🔧 Расширенная Конфигурация
### Пользовательские Правила Ограничений
Создать файл `constraint-config.json`:
```json
{
"openapi": {
"version": "3.0.0",
"strictMode": true,
"validateResponses": true
},
"validation": {
"realTime": true,
"autoFix": true
}
}
```
### Многоязычная Поддержка
Поддерживаемые форматы команд:
- Китайский: `.use interface`, `.使用接口`
- Английский: `.use interface`, `.apply constraints`
## 📚 Ссылки на Документацию
- [Полное Руководство по Развертыванию](./COMPLETE-DEPLOYMENT-GUIDE.md)
- [Руководство по Интеллектуальным Ограничениям](./INTELLIGENT-VALIDATION-GUIDE.md)
- [Устранение Неполадок](./TROUBLESHOOTING.md)
- [Справочник API](./api/README.md)
- [Примеры Использования](./examples/README.md)
## 🌟 Ключевые Преимущества
- **Запуск Без Конфигурации** - Готов к использованию после установки, сложная конфигурация не нужна
- **Интеллектуальное Распознавание** - Автоматически распознавать требования валидации интерфейса
- **Обратная Связь в Реальном Времени** - Мгновенная проверка согласованности интерфейса
- **Кроссплатформенная Поддержка** - Полная поддержка Windows, macOS, Linux
- **Открытый Исходный Код и Бесплатно** - Лицензия MIT, полностью открытый исходный код
## 🤝 Вклад
Issues и Pull Requests приветствуются!
## 📄 Лицензия
Лицензия MIT - См. файл [LICENSE](../LICENSE) для подробностей
