Rhombus MCP Server

Um servidor MCP para a API Rhombus, oferecendo recursos avançados de segurança e vigilância.

Documentação

🚀 Rhombus MCP Server - Turbine suas Ferramentas de IA!

smithery badge

Libere o poder da API Rhombus com esta implementação de servidor MCP de ponta! Transforme sua experiência de chatbot com recursos avançados de segurança e vigilância ao seu alcance.

🔍 Sobre a Rhombus

A Rhombus é o sistema de segurança comercial nº 1, construído para proteger e projetado para se adaptar! Oferecemos segurança física de nível empresarial com foco em cibersegurança, combinando:

  • 💡 Câmeras Inteligentes - Câmeras de segurança inovadoras: dome, olho de peixe, bala e multissensor
  • 🚪 Controle de Acesso - Controladores de porta, leitores e interfones seguros com acesso por celular, cartão e chaveiro
  • 📡 Sensores IoT - Sensores avançados de áudio, ambientais, de movimento, de entrada e de pânico multiuso
  • 🔒 Monitoramento de Alarme - Verificação e despacho de agente ao vivo certificado TMA 5 diamantes

Nossa plataforma é alimentada por insights de IA acionáveis que ajudam você a responder mais rápido com detecções em tempo real, tudo isso enraizado em fortes princípios de cibersegurança.

🧪 Participe do Nosso Teste Beta!

Estamos muito animados em fazer parte da Geração de IA! Ajude-nos a moldar o futuro da segurança com IA testando nossa implementação do servidor MCP e fornecendo feedback valioso.

👉 Preencha nosso formulário de teste beta aqui 👈

Seus insights influenciarão diretamente nosso roteiro de desenvolvimento e nos ajudarão a criar as ferramentas de segurança com IA mais poderosas do mercado!

🔧 Configuração Rápida

Instalando via Smithery

Para instalar o Rhombus MCP Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @RhombusSystems/rhombus-node-mcp --client claude

Passo 1: Dê Superpoderes ao Seu Console Rhombus

  1. Faça login no seu Console Rhombus - Entre aqui! 🔐
  2. Gere sua chave mágica em Configurações de Chave de API ✨
  3. Ative seus poderes definindo RHOMBUS_API_KEY no seu ambiente 💪

Passo 2: Turbine o Claude Desktop

  1. Pegue o incrível Claude desktop bem aqui! 📥

  2. Libere a magia adicionando isso ao seu claude_desktop_config.json:

DOCKER

{
  "mcpServers": {
    "rhombus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "RHOMBUS_API_KEY=YOUR_API_KEY_HERE",
        "rhombussystems/mcp-server-rhombus"
      ],
      "env": {
        "RHOMBUS_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "rhombus": {
      "command": "npx",
      "args": ["--yes", "--package", "rhombus-node-mcp", "mcp-server-rhombus"],
      "env": {
        "RHOMBUS_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Você pode acessar o arquivo usando:

vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

Passo 3: Dê uma Volta! 🎡

Hora de ver a mágica acontecer! Vamos verificar se o Claude for Desktop está detectando nossas incríveis ferramentas do servidor rhombus:

  1. Procure o poderoso ícone de martelo na interface do Claude ⚒️
  2. Clique nele para revelar seu novo arsenal de ferramentas
  3. Encontre as ferramentas do Filesystem MCP Server na lista

Se estiverem visíveis, VOCÊ CONSEGUIU! 🎉 Sua integração está ativa e pronta para funcionar! O Claude agora pode se comunicar diretamente com os sistemas Rhombus, dando a você as mesmas capacidades incríveis do aplicativo web Rhombus, mas com o poder adicional da inteligência do Claude!

🚀 Executando Localmente: Liberte Seu Desenvolvedor Interior!

Quer colocar a mão na massa e testar o servidor Rhombus MCP diretamente na sua máquina? Siga estes passos para construir e executar uma imagem Docker local e, em seguida, conecte-a ao cliente MCP de sua escolha!

1. Construa Sua Imagem Docker Local 🛠️

Primeiro, vamos construir essa imagem Docker. Isso permitirá que você execute o servidor MCP em um ambiente local.

npm install
docker build -t mcp-server-rhombus .

2. Atualize Sua Configuração do Claude para Uso Local ⚡

Agora, você precisará ajustar seu claude_desktop_config.json para apontar para a imagem Docker local recém-construída.

Nota: Ao executar localmente, o nome da imagem Docker muda para mcp-server-rhombus de rhombussystems/mcp-server-rhombus. Certifique-se de atualizar isso na sua configuração!

{
  "mcpServers": {
    "rhombus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "RHOMBUS_API_KEY=YOUR_API_KEY_HERE",
        "mcp-server-rhombus"
      ],
      "env": {
        "RHOMBUS_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Criando uma nova ferramenta

Escrevemos um script que você pode executar para começar a desenvolver uma nova ferramenta além do nosso conjunto de ferramentas existente. Você pode simplesmente chamar:

npm run create:tool

🧪 Executando Testes

Os testes são escritos com Vitest e ficam ao lado dos arquivos de origem como *.test.ts.

1. Configure Seu Ambiente de Teste

Copie o modelo e preencha seus valores:

cp .env.test.template .env.test

Em seguida, edite .env.test:

VariávelDescrição
RHOMBUS_API_KEYSua chave de API Rhombus — gere uma em Gerenciamento de API
API_HOSTNAMEURL base da API — o padrão é https://api.rhombus.com (substitua para staging/dev)
CAMERA_UUIDUUID de uma câmera na sua organização para usar em testes de integração

.env.test é ignorado pelo git — nunca envie credenciais reais.

2. Execute os Testes

# Run all tests once
npm test

# Watch mode — re-runs on file changes
npm run test:watch

Enfrentando um Problema? Nós Te Ajudamos! 🛟

Confira o fantástico guia de solução de problemas do Claude para correções rápidas! Ainda preso? Nossa equipe de especialistas está pronta para ajudar!

Estamos comprometidos em tornar sua experiência perfeitamente tranquila e estamos MUITO animados para saber quais aplicativos incríveis você está construindo com nossas ferramentas!

🤝 Queremos Seu Feedback!

Como pioneiros na Geração de IA, somos apaixonados por ultrapassar os limites do que é possível ao combinar segurança física avançada com ferramentas de IA de ponta. Seu feedback é inestimável enquanto continuamos a inovar e melhorar.

  • Quais recursos tornariam seu fluxo de trabalho ainda melhor?
  • Como você está usando nosso servidor MCP em seus projetos?
  • Quais integrações você gostaria de ver a seguir?

Compartilhe seus pensamentos, ideias e histórias de sucesso conosco! Juntos, estamos criando o futuro da segurança inteligente.

📜 Licença

Este incrível servidor MCP vem com a liberdade da Licença MIT! ✅ Use-o, ✅ modifique-o, ✅ compartilhe-o - as possibilidades são infinitas! Apenas lembre-se de seguir os termos e condições da Licença MIT. Confira o arquivo LICENSE em nosso repositório para todos os detalhes.