Specbridge MCP сервер

MCP сервер, который автоматически конвертирует OpenAPI спецификации в MCP инструменты, сканируя папку с файлами спецификаций и генерируя соответствующие инструменты без дополнительной конфигурации.

Установка

NPM Global

npm install -g specbridge

NPX

npx -y specbridge --specs /path/to/specs

Конфигурация

Claude Desktop (Установленный)

{
  "mcpServers": {
    "specbridge": {
      "command": "specbridge",
      "args": ["--specs", "/path/to/your/specs/folder"]
    }
  }
}

Claude Desktop (NPX)

{
  "mcpServers": {
    "specbridge": {
      "command": "npx",
      "args": ["-y", "specbridge", "--specs", "/absolute/path/to/your/specs"]
    }
  }
}

Доступные инструменты

Возможности

• Нулевая конфигурация - файловая система является интерфейсом, просто добавьте OpenAPI спецификации в папку
• Автоматическая аутентификация с простым .env файлом, используя паттерн {API_NAME}_API_KEY
• Изоляция пространства имён - множественные API мирно сосуществуют с префиксными именами инструментов
• Полная поддержка OpenAPI - обрабатывает параметры, тела запросов, аутентификацию и ответы
• Множественные транспорты - поддерживает stdio и HTTP стриминг
• Встроенная отладка с list командой для просмотра загруженных спецификаций и инструментов

Переменные окружения

Опциональные

• {API_NAME}_API_KEY - API ключ для аутентификации, отправляется как X-API-Key заголовок
• {API_NAME}_TOKEN - Bearer токен для аутентификации, отправляется как Authorization: Bearer заголовок
• {API_NAME}_BEARER_TOKEN - Bearer токен для аутентификации, отправляется как Authorization: Bearer заголовок
• {API_NAME}_USERNAME - Имя пользователя для базовой аутентификации (требует соответствующий PASSWORD)
• {API_NAME}_PASSWORD - Пароль для базовой аутентификации (требует соответствующий USERNAME)

Примеры использования

Загрузите и используйте Petstore API для получения информации о питомцах

Взаимодействуйте с GitHub API эндпоинтами, используя сгенерированные инструменты

Вызывайте любые API эндпоинты, определённые в ваших OpenAPI спецификациях

Ресурсы

• GitHub Repository

Примечания

API_NAME выводится из имени файла вашей OpenAPI спецификации (например, petstore.json → PETSTORE_API_KEY). Инструменты именуются по паттерну {api_name}{operationId} или {api_name}{method}_{path_segments}. Лучше всего работает с абсолютными путями, не содержащими пробелов. Поддерживает файлы OpenAPI спецификаций .json, .yaml и .yml.