MCP Football Server

MCP Football Server

MCP Football Server é um servidor de ferramentas leve do Model Context Protocol (MCP) que fornece dados de futebol para clientes e assistentes de IA via API-Football. Projetado para analistas esportivos e usuários em geral, permite acesso em tempo real a jogos, classificações, times, jogadores e muito mais.

Recursos

O MCP Football Server expõe um conjunto de ferramentas que uma IA ou aplicação pode chamar para buscar dados de futebol. Os principais recursos incluem:

• Jogos por data
• Classificações de ligas
• Informações de times e jogadores
• Transferências, lesões, confrontos diretos
• Integração fácil com clientes MCP

Configuração (Servidor Local)

1. Clone e instale as dependências

   git clone https://github.com/yalmeidarj/mcp-football-server.git
   cd mcp-football-server
   npm install
   

2. Inicie em desenvolvimento

   npm run dev
   

3. Ou compile para produção

   npm run build
   npm start
   

O servidor se comunica via STDIN/STDOUT usando MCP JSON-RPC. A etapa de compilação transpila os arquivos de origem para o diretório build/, e o npm start executa o servidor compilado GitHub. Após a compilação, você também pode usar o comando football (definido como um binário no pacote) para iniciar o servidor GitHub.

Configuração do Cliente (Claude Desktop)

Para usar com o Claude Desktop:

• Adicione o seguinte ao seu claude_desktop_config.json:

  {
    "mcpServers": {
      "football": {
        "command": "node",
        "args": ["<path_to>/build/main.js"],
        "env": {
          "RAPIDAPI_KEY": "<your_rapidapi_key>",
          "RAPIDAPI_HOST": "api-football-v1.p.rapidapi.com"
        }
      }
    }
  }
  

O Claude iniciará o servidor automaticamente e usará suas ferramentas para consultas relacionadas a futebol.

Pilha de Tecnologias

• Node.js + TypeScript
• MCP SDK para servir ferramentas via stdio
• node-fetch para chamadas de API
• Zod para validação de parâmetros

Licença

Lançado sob a Licença ISC.

---