Servidor InfluxDB MCP

O que faz o Servidor “InfluxDB” MCP?

O Servidor InfluxDB MCP é um servidor Model Context Protocol (MCP) projetado para fornecer acesso perfeito a uma instância InfluxDB usando a OSS API v2 do InfluxDB. Ele atua como uma ferramenta intermediária que conecta assistentes de IA a dados de séries temporais armazenados no InfluxDB, possibilitando fluxos de trabalho aprimorados para desenvolvedores e sistemas de IA. Por meio de sua interface padronizada, o servidor expõe tanto recursos (como organizações, buckets e medições) quanto ferramentas (como consulta e gravação de dados), capacitando clientes de IA a realizar tarefas como executar consultas no banco de dados, gerenciar buckets de dados ou integrar análises de séries temporais em suas aplicações. Esta integração robusta garante que desenvolvedores possam automatizar o tratamento de dados, simplificar seus processos de desenvolvimento e aumentar a inteligência de suas aplicações aproveitando dados em tempo real e históricos do InfluxDB.

Lista de Prompts

• flux-query-examples: Fornece modelos comuns de consultas Flux para simplificar a escrita e execução de consultas típicas no InfluxDB.
• line-protocol-guide: Oferece um guia e modelo para uso do formato line protocol do InfluxDB, auxiliando nas operações de gravação de dados.

Lista de Recursos

• Lista de Organizações (influxdb://orgs): Mostra todas as organizações presentes na instância InfluxDB.
• Lista de Buckets (influxdb://buckets): Exibe todos os buckets com metadados associados.
• Medições do Bucket (influxdb://bucket/{bucketName}/measurements): Lista todas as medições dentro de um bucket especificado.
• Consulta de Dados (influxdb://query/{orgName}/{fluxQuery}): Executa uma consulta Flux e retorna os resultados como recurso.

Lista de Ferramentas

• write-data: Grava dados de séries temporais no formato line protocol do InfluxDB. Parâmetros incluem org, bucket, dados e precisão opcional.
• query-data: Executa consultas Flux contra a instância do InfluxDB. Requer os parâmetros org e query.
• create-bucket: Cria um novo bucket no banco de dados. Parâmetros: nome, orgID e período de retenção opcional.
• create-org: Cria uma nova organização no InfluxDB. Parâmetros: nome e descrição opcional.

Casos de Uso deste Servidor MCP

• Consulta de Dados de Séries Temporais: Execute facilmente consultas Flux avançadas nos dados do InfluxDB, permitindo que desenvolvedores e agentes de IA recuperem, analisem e visualizem dados de séries temporais.
• Ingestão Automatizada de Dados: Automatize o processo de gravação de pontos de dados no InfluxDB usando o line protocol, otimizando pipelines de IoT ou telemetria.
• Gerenciamento de Banco de Dados: Crie programaticamente novas organizações e buckets, simplificando a gestão de infraestrutura para grandes implantações ou multi-tenant do InfluxDB.
• Descoberta de Medições: Liste dinamicamente as medições disponíveis em um bucket, auxiliando aplicações que precisam se adaptar a esquemas de dados em mudança.
• Análises Assistidas por IA: Permita que assistentes de IA exponham, contextualizem e manipulem dados do InfluxDB como parte de fluxos analíticos ou de monitoramento mais amplos.

Como configurar

Windsurf

1. Verifique se o Node.js está instalado em sua máquina.

2. Abra o arquivo de configuração do Windsurf (ex.: windsurf.json ou equivalente).

3. Adicione o Servidor InfluxDB MCP ao objeto mcpServers:

   {
     "mcpServers": {
       "influxdb-mcp": {
         "command": "npx",
         "args": [
           "@idoru/influxdb-mcp-server@latest",
           "serve"
         ]
       }
     }
   }
   

4. Salve o arquivo e reinicie o Windsurf.

5. Verifique conferindo se o Servidor InfluxDB MCP aparece na lista de servidores MCP.

Protegendo Chaves de API
Defina valores sensíveis como variáveis de ambiente. Exemplo:

{
  "mcpServers": {
    "influxdb-mcp": {
      "command": "npx",
      "args": [
        "@idoru/influxdb-mcp-server@latest",
        "serve"
      ],
      "env": {
        "INFLUXDB_TOKEN": "${INFLUXDB_TOKEN_ENV}"
      }
    }
  }
}

Claude

1. Instale o Node.js se ainda não estiver presente.

2. Localize o arquivo de configuração do Claude.

3. Adicione o Servidor InfluxDB MCP a mcpServers:

   {
     "mcpServers": {
       "influxdb-mcp": {
         "command": "npx",
         "args": [
           "@idoru/influxdb-mcp-server@latest",
           "serve"
         ]
       }
     }
   }
   

4. Salve as alterações e reinicie o Claude.

5. Confirme a configuração pela interface do Claude.

Protegendo Chaves de API
(Veja o exemplo do Windsurf acima.)

Cursor

1. Verifique se o Node.js está presente.

2. Abra as configurações ou o arquivo de configuração do Cursor.

3. Adicione o Servidor InfluxDB MCP usando:

   {
     "mcpServers": {
       "influxdb-mcp": {
         "command": "npx",
         "args": [
           "@idoru/influxdb-mcp-server@latest",
           "serve"
         ]
       }
     }
   }
   

4. Salve e reinicie o Cursor.

5. Verifique a conectividade do servidor MCP.

Protegendo Chaves de API
(Veja o exemplo do Windsurf acima.)

Cline

1. Certifique-se de que o Node.js está instalado.

2. Edite o arquivo de configuração do Cline.

3. Insira o seguinte em mcpServers:

   {
     "mcpServers": {
       "influxdb-mcp": {
         "command": "npx",
         "args": [
           "@idoru/influxdb-mcp-server@latest",
           "serve"
         ]
       }
     }
   }
   

4. Salve o arquivo e reinicie o Cline.

5. Valide que o servidor está ativo no Cline.

Protegendo Chaves de API
(Veja o exemplo do Windsurf acima.)

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "influxdb-mcp": {
    "transport": "streamable_http",
    "url": "https://seumcpserver.exemplo/caminhoparaomcp/url"
  }
}

Uma vez configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “influxdb-mcp” para o nome real do seu servidor MCP e substituir a URL pela do seu próprio servidor MCP.

Visão Geral

Suporte a Roots: ⛔ Não mencionado

Com base no exposto acima, este servidor MCP está bem documentado para seus recursos principais de integração com o InfluxDB. Ele expõe claramente recursos e ferramentas, inclui modelos de prompts e fornece boas orientações de configuração. No entanto, recursos avançados MCP como roots e sampling não estão documentados, o que limita um pouco sua extensibilidade para alguns fluxos de trabalho.

Nossa opinião

Este é um servidor MCP robusto e prático para InfluxDB com utilidade clara para dados de séries temporais e tarefas de automação. Ele obtém ótima pontuação para uso prático por desenvolvedores, embora careça de documentação sobre recursos MCP avançados.

Pontuação MCP