MCP-Soccerdata MCP Server

O que faz o servidor MCP “MCP-Soccerdata”?

O MCP-Soccerdata é um servidor Model Context Protocol (MCP) de código aberto que se conecta à SoccerDataAPI para entregar informações atualizadas de partidas de futebol via interações em linguagem natural. Projetado para uso com clientes compatíveis com MCP, como o Claude Desktop, permite que usuários e assistentes de IA acessem dados estruturados e em tempo real de futebol, aproveitando modelos de linguagem (LLMs). O servidor oferece insights ao vivo sobre partidas em andamento, listagem de jogos, escalação das equipes, eventos importantes, probabilidades de apostas e metadados das ligas. Essa integração possibilita fluxos de trabalho de IA para consultas de dados de futebol, facilitando experiências mais ricas de desenvolvimento, pesquisa e engajamento de fãs.

Lista de Prompts

Nenhum modelo de prompt está explicitamente documentado no repositório.

Lista de Recursos

• Listagem de Partidas ao Vivo
  Fornece uma lista global de todas as partidas de futebol ativas no momento, incluindo nomes dos times, horários de início, detalhes do estádio e placares atuais.
• Detalhes das Partidas
  Apresenta informações sobre o status das partidas (agendada, em andamento, finalizada), detalhamento de gols e resultados finais.
• Eventos Importantes das Partidas
  Entrega dados estruturados sobre gols, substituições, cartões amarelos/vermelhos e pênaltis de cada partida.
• Escalações das Equipes
  Oferece detalhes sobre o time titular, reservas, situação de lesões e formações das equipes.

Lista de Ferramentas

Não há listagem explícita de ferramentas nem detalhes do arquivo server.py disponíveis no repositório ou documentação.

Casos de Uso deste Servidor MCP

• Monitoramento de Partidas de Futebol ao Vivo
  Desenvolvedores ou agentes de IA podem obter dados atualizados minuto a minuto sobre jogos de futebol em andamento pelo mundo.
• Geração Automática de Relatórios Esportivos
  Geração automática de resumos de partidas, detalhamento de eventos e análise de escalações para mídias ou sites de fãs.
• Bots de Engajamento de Fãs
  Alimenta chatbots que respondem perguntas sobre placares ao vivo, próximos jogos ou estatísticas de jogadores.
• Aplicações para Análise de Apostas
  Integra probabilidades e dados de partidas em tempo real em ferramentas de recomendação ou análise de apostas.
• Acompanhamento de Ligas e Torneios
  Permite criar dashboards para acompanhar classificações, resultados de partidas e estatísticas em diversas ligas e torneios.

Como configurar

Windsurf

1. Certifique-se de ter o Node.js e o Windsurf instalados.
2. Localize seu arquivo de configuração do Windsurf (por exemplo, windsurf.json).
3. Adicione o servidor MCP-Soccerdata à seção mcpServers com o seguinte trecho de JSON:

   {
     "mcpServers": {
       "soccerdata": {
         "command": "npx",
         "args": ["@yeonupark/mcp-soccer-data@latest"]
       }
     }
   }
   

4. Salve a configuração e reinicie o Windsurf.
5. Verifique se o servidor está rodando e acessível.

Claude

1. Instale o Claude Desktop e certifique-se de que está atualizado.
2. Abra o arquivo de configuração do Claude (local varia conforme o sistema operacional).
3. Adicione o servidor MCP-Soccerdata à seção mcpServers:

   {
     "mcpServers": {
       "soccerdata": {
         "command": "npx",
         "args": ["@yeonupark/mcp-soccer-data@latest"]
       }
     }
   }
   

4. Salve as alterações e reinicie o Claude Desktop.
5. Confirme a conexão com sucesso na interface do Claude.

Cursor

1. Instale o Cursor IDE e certifique-se de que o Node.js está disponível.
2. Abra ou crie um arquivo .cursorconfig no seu workspace.
3. Insira a configuração do servidor:

   {
     "mcpServers": {
       "soccerdata": {
         "command": "npx",
         "args": ["@yeonupark/mcp-soccer-data@latest"]
       }
     }
   }
   

4. Salve e recarregue o Cursor.
5. Verifique se o servidor MCP aparece no painel de extensões do Cursor.

Cline

1. Instale o cliente de terminal Cline.
2. Abra seu arquivo de configuração .cline.json.
3. Adicione a configuração:

   {
     "mcpServers": {
       "soccerdata": {
         "command": "npx",
         "args": ["@yeonupark/mcp-soccer-data@latest"]
       }
     }
   }
   

4. Salve e reinicie o Cline.
5. Use o comando cline mcp list para verificar a conexão.

Protegendo Chaves de API

Armazene chaves de API sensíveis em variáveis de ambiente e as passe pelo campo env na configuração. Exemplo:

{
  "mcpServers": {
    "soccerdata": {
      "command": "npx",
      "args": ["@yeonupark/mcp-soccer-data@latest"],
      "env": {
        "SOCCERDATA_API_KEY": "${SOCCERDATA_API_KEY}"
      },
      "inputs": {
        "apiKey": "${SOCCERDATA_API_KEY}"
      }
    }
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo do FlowHunt, comece adicionando o componente MCP ao 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 sistema MCP, insira os detalhes do seu servidor MCP utilizando este formato JSON:

{
  "MCP-Soccerdata": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Uma vez configurado, o agente de IA poderá utilizar este MCP como ferramenta, acessando todas as suas funções e capacidades. Lembre-se de alterar “MCP-Soccerdata” para o nome real do seu servidor MCP e atualizar a URL conforme necessário.

Visão geral

Nossa opinião

O MCP-Soccerdata entrega um servidor de dados de futebol em tempo real focado, com recursos bem descritos e instruções de configuração. No entanto, a ausência de modelos de prompt documentados e definições explícitas de ferramentas limita a flexibilidade pronta para uso e a adoção por desenvolvedores para fluxos MCP avançados.

Pontuação MCP

Com base nas tabelas acima, eu avaliaria este servidor MCP com 5 de 10: oferece funcionalidades centrais e documentação sólidas para dados de futebol, mas carece de recursos MCP mais avançados como modelos de prompt, listagem de ferramentas e suporte claro a sampling/roots para integrações avançadas.