Soccerdata MCP Server

Fornece informações em tempo real de partidas de futebol da SoccerDataAPI usando linguagem natural.

GitHub
39
Experimente este MCPPatrocinado

Documentação

MseeP.ai Security Assessment Badge

⚽️ Soccerdata MCP Server

smithery badge

  • MCP-Soccerdata é um servidor open-source do Model Context Protocol (MCP) que se conecta à SoccerDataAPI para fornecer informações atualizadas de partidas de futebol por meio de interações em linguagem natural.

  • Projetado para uso com clientes habilitados para MCP, como o Claude Desktop, permite que os usuários obtenham dados de futebol aproveitando grandes modelos de linguagem (LLMs).

✨ Recursos

🏟️ Insights de Partidas de Futebol ao Vivo

O MCP-Soccerdata foca em fornecer informações em tempo real sobre partidas de futebol em andamento ao redor do mundo.

"Quais partidas de futebol estão sendo jogadas agora?"
"Quais são as escalações previstas para PSG vs Aston Villa hoje?"
"Por favor, informe os placares e o número de gols das partidas de futebol recentes."

→ Fornece dados de futebol relevantes em um formato estruturado, incluindo as categorias detalhadas descritas abaixo.

- Listagens de Partidas e Informações Básicas

  • Lista global de todas as partidas atualmente ativas
  • Nomes dos times da casa e visitante
  • Horário de início e data da partida
  • Detalhes do estádio
  • Placar atual

- Detalhes da Partida

  • Status da partida: agendada, em andamento ou encerrada
  • Detalhamento de gols: primeiro tempo, segundo tempo, prorrogação, disputa de pênaltis
  • Resultado final: vitória, empate ou derrota

- Eventos-Chave da Partida

  • Eventos de gol (quem marcou, quando, como)
  • Substituições
  • Cartões amarelos e vermelhos
  • Pênaltis

- Escalações dos Times

  • Time titular (XI inicial)
  • Jogadores no banco
  • Status de lesões
  • Formação do time

- Odds e Informações de Apostas

  • Odds de Vitória / Empate / Derrota
  • Odds de Over / Under
  • Odds de apostas com handicap

- Metadados da Liga

  • Nome da liga
  • País
  • Formato da competição (ex.: temporada regular, fase eliminatória)

⚠️ Focado exclusivamente em partidas ao vivo, próximas e recentemente encerradas

🎥 Demonstração

mcp (3) (1)

🚀 Início Rápido

Instalação via Smithery

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

npx -y @smithery/cli install @yeonupark/mcp-soccer-data --client claude

Pré-requisitos

  • Python 3.12+
  • Gerenciador de pacotes uv
  • Conta na Soccerdata API
  • Cliente compatível com MCP (ex.: Claude for Desktop)

1. Clonar e Configurar

  • Clone o repositório
git clone https://github.com/yeonupark/mcp-soccer-data.git
cd mcp-soccer-data
  • Instale as dependências
uv sync

2. Obtenha Sua Chave de API e Configure o Ambiente

  • Crie um arquivo .env com suas credenciais:
AUTH_KEY=your_auth_key

Cadastre-se em https://soccerdataapi.com/ e obtenha suas próprias chaves de autenticação.

3. Configure o Cliente MCP

  • Registre este servidor no seu cliente MCP (ex.: Claude for Desktop).

Edite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
      "mcp-soccer-data": {
          "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
          "args": [
              "--directory",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/",
              "run",
              "--env-file",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/.env",
              "server.py"
          ]
      }
  }
}

🛠️ Ferramentas

A seguinte ferramenta é exposta aos clientes MCP:

get_livescores()

-> Retorna informações em tempo real sobre partidas de futebol em andamento ao redor do mundo.

📝 Licença