Swagger MCP Server

Um exemplo de servidor MCP para implantação no Cloudflare Workers sem autenticação.

GitHubExperimente este MCPPatrocinado

Documentação

Acceleronix OpenAPI Swagger Doc MCP Server

Um servidor abrangente do Model Context Protocol (MCP) que fornece acesso contínuo a 32 OpenAPIs do Acceleronix Developer Center. Construído em Cloudflare Workers com gerenciamento inteligente de ferramentas e autenticação por token Bearer.

Recursos

  • 32 Acceleronix PaaS OpenAPIs: Cobertura abrangente de gerenciamento de dispositivos, armazenamento de dados, serviços familiares e muito mais
  • Gerenciamento Inteligente de Ferramentas: Balanceamento de carga inteligente com 3-8 ferramentas por API (~100 ferramentas no total)
  • Arquitetura em Múltiplas Camadas: Níveis de acesso EndUser, Enterprise e Open API
  • Autenticação por Token Bearer: Autenticação unificada em todas as APIs
  • Acesso em Tempo Real: Implantado em Cloudflare Workers para acesso global de baixa latência
  • Integração com Claude: Integração direta com Claude Desktop e AI Playground

Categorias de API Suportadas

Gerenciamento Principal de Dispositivos (18 APIs Habilitadas)

  • Device Manager (Enterprise) - Gerenciamento do ciclo de vida e configuração de dispositivos
  • Device Shadow (Enterprise) - Sincronização de estado de dispositivos e operações de shadow
  • Binding Service (EndUser/Enterprise) - Vinculação de dispositivos e associação de usuários
  • DeviceGroup Service (EndUser) - Gerenciamento de grupos e operações em lote

Serviços de Plataforma

  • App Service (EndUser) - Gerenciamento e implantação de aplicativos
  • Family Service (EndUser) - Gerenciamento de contas familiares multiusuário
  • EndUser Service (EndUser) - Operações de perfil de usuário e conta
  • Product Management (Enterprise) - Catálogo de produtos e ciclo de vida

Dados e Análises

  • Data Storage (EndUser) - Armazenamento e recuperação de dados de séries temporais
  • Weather Service (EndUser) - Integração de dados meteorológicos
  • Rule Engine (EndUser) - Processamento de eventos e regras de automação
  • Category Management (EndUser) - Categorização de dispositivos e taxonomia

Serviços de Infraestrutura

  • OTA Service (EndUser) - Atualizações de firmware over-the-air
  • Thing Specification Language (Enterprise) - Definições de modelos de dispositivos
  • Matter Service (EndUser) - Integração do protocolo Matter
  • I18n Service (EndUser) - Internacionalização e localização
  • Global Bootstrap (Open) - Serviços de inicialização da plataforma

APIs Adicionais (14 Disponíveis, Atualmente Desabilitadas)

  • Mail Service, Mobile Push, OEM App, Portal Service, Work Order, SMS, Streaming Media e mais

Início Rápido

Implantar em Cloudflare Workers

# Clone the repository
git clone <repository-url>
cd swagger-mcp-server

# Install dependencies
npm install

# Deploy to Cloudflare Workers
npm run deploy

Seu servidor MCP estará disponível em: https://swagger-mcp-server.<your-account>.workers.dev/sse

Desenvolvimento Local

# Start local development server
npm run dev

# Server available at: http://localhost:8787/sse

Configuração

Configuração do Token Bearer

Atualize os tokens de autenticação em src/config.ts:

{
  name: "device_mgr_enterprise",
  title: "IoT Device Manager (Enterprise)",
  auth: { type: 'bearer', token: 'your-bearer-token-here' },
  enabled: true,
  maxTools: 8
}

Habilitar/Desabilitar APIs

Controle quais APIs estão ativas modificando a flag enabled:

{
  "name": "mail_enduser",
  "title": "Mail Service (EndUser)",
  "enabled": false,  // Set to true to enable
  "maxTools": 4
}

Integração com Claude Desktop

Adicione à sua configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "iot-apis": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://swagger-mcp-server.your-account.workers.dev/sse"
      ]
    }
  }
}

Ferramentas Disponíveis

O servidor gera automaticamente ferramentas a partir das especificações Swagger com nomenclatura inteligente:

  • device_mgr_enterprise_getDevices - Listar todos os dispositivos
  • binding_enduser_bindDevice - Vincular dispositivo ao usuário
  • deviceshadow_enterprise_updateShadow - Atualizar shadow do dispositivo
  • weather_enduser_getCurrentWeather - Obter dados meteorológicos atuais
  • E cerca de 96 ferramentas adicionais em todas as APIs habilitadas

Ferramentas de Gerenciamento

Listar APIs Disponíveis

# Using Claude
"List all available APIs and their status"

Testar Conexão

# Using Claude  
"Test the MCP server connection"

Arquitetura

Claude Desktop/AI Playground
           ↓
    MCP JSON-RPC 2.0
           ↓
   Cloudflare Workers
           ↓
    McpAgent (Durable Objects)
           ↓
   Multi-API Tool Router
           ↓
    32 IoT APIs (Acceleronix)

Estratégia de Distribuição de Ferramentas

  • APIs de Alta Prioridade: 6-8 ferramentas cada (Device Management, Product, TSL)
  • APIs de Prioridade Média: 4-6 ferramentas cada (Binding, Shadow, Data Storage)
  • APIs Utilitárias: 3-4 ferramentas cada (Weather, I18n, Bootstrap)
  • Total: ~100 ferramentas em 18 APIs habilitadas

Recursos de Segurança

  • Autenticação por token Bearer para todas as chamadas de API
  • Suporte a variáveis de ambiente para tokens sensíveis
  • CORS habilitado para clientes de navegador
  • Validação de requisições e tratamento de erros

Endpoints

  • MCP SSE: /sse - Endpoint Server-Sent Events para Claude
  • Health Check: /health - Status do serviço e informações de versão
  • MCP JSON-RPC: /mcp - Endpoint direto JSON-RPC 2.0

Documentação da API

Cada API fornece documentação Swagger abrangente acessível por meio das ferramentas. Use a ferramenta list_apis para ver todas as APIs disponíveis e suas descrições.

Contribuindo

  1. Faça um fork do repositório
  2. Adicione novas APIs a src/config.ts
  3. Teste localmente com npm run dev
  4. Implante e teste com Claude Desktop
  5. Envie um pull request

Licença

Licença MIT - consulte o arquivo LICENSE para obter detalhes