NS Travel Information MCP Server

NS Travel Information MCP Server

Transforme seu assistente de IA em um especialista em ferrovias holandesas! Este servidor MCP conecta o Claude a informações de viagem em tempo real da NS (Nederlandse Spoorwegen), tornando-o seu companheiro perfeito para navegar pelos Países Baixos de trem.

Instalação

Você pode instalar este servidor de três maneiras:

1. Usando o Claude Desktop com Pacote NPM

Atualize seu arquivo de configuração do Claude (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "ns-server": {
      "command": "npx",
      "args": [
        "-y",
        "ns-mcp-server"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Você pode obter uma chave de API no NS API Portal

2. Usando Smithery

Para instalar o NS Travel Information Server automaticamente via Smithery:

npx -y @smithery/cli install ns-server --client claude

3. A partir do código-fonte

1. Clone este repositório
2. Instale as dependências:

   npm install
   

3. Copie o arquivo de ambiente de exemplo:

   cp .env.example .env
   

4. Adicione sua chave de API da NS ao arquivo .env:

   NS_API_KEY=your_api_key_here
   

Em seguida, atualize seu arquivo de configuração do Claude:

{
  "mcpServers": {
    "ns-server": {
      "command": "node",
      "args": [
        "/path/to/ns-server/build/index.js"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Certifique-se de:

1. Substituir /path/to/ns-server pelo caminho real da sua instalação
2. Adicionar sua chave de API da NS na seção env. Ela pode ser obtida aqui https://apiportal.ns.nl/product#product=NsApp

Após atualizar a configuração, reinicie o Claude Desktop para que as alterações tenham efeito.

Casos de Uso no Mundo Real

• "Meu trem habitual das 8:15 de Almere para Amsterdã está no horário?"
• "Há atrasos na rota Rotterdam-Den Haag hoje?"
• "Qual é a melhor rota alternativa para Utrecht se houver manutenção na linha direta?"
• "Qual trem devo pegar para chegar ao meu escritório em Amsterdã Zuid antes das 9h?"
• "Qual rota para Amsterdã tem menos baldeações com um carrinho de bebê?"
• "Qual é o primeiro trem que posso pegar para chegar à minha reunião das 10h em Haia?"
• "Qual é o último trem de volta para Groningen depois de uma noite em Amsterdã?"
• "Há obras de engenharia no fim de semana que possam afetar minha aula de segunda de manhã?"
• "Há bicicletas OV-fiets disponíveis em Utrecht Centraal para minha reunião da tarde?"
• "A estação Eindhoven Strijp-S é acessível para cadeirantes e quais plataformas ela tem?"
• "Quais trens estão chegando a Utrecht Centraal na próxima hora?"
• "O trem de Venlo para o Aeroporto de Schiphol chegou no horário?"
• "Quanto custa uma passagem de primeira classe de Amsterdã para Rotterdam?"
• "Qual é o preço para 2 adultos e 1 criança viajando para Den Haag?"

🔑 Variáveis de Ambiente

Variável	Descrição
NS_API_KEY	Sua chave de API da NS (obrigatória)

🌟 Recursos

Este servidor MCP fornece acesso abrangente às informações de trem da NS por meio dos seguintes endpoints:

Informações de Trem em Tempo Real

• Partidas: Obtenha informações de partida em tempo real, incluindo números de plataforma, atrasos e notas de viagem
• Chegadas: Acesse as próximas chegadas de trens com estações de origem, mudanças de plataforma e atualizações de status
• Planejamento de Viagem: Encontre rotas de viagem ideais com baldeações e atualizações em tempo real
• Atualizações de Serviço: Verifique interrupções, trabalhos de manutenção e atividades de engenharia

Informações de Preços

• Preços de Passagens: Obtenha preços precisos para viagens de ida e volta
• Classes de Viagem: Compare preços para viagens de primeira e segunda classe
• Preços para Grupos: Calcule tarifas para adultos e crianças
• Opções de Desconto: Verifique descontos para viagens conjuntas e ofertas especiais
• Detalhes de Validade: Veja períodos de validade das passagens e condições de viagem

Informações de Estações

• Detalhes da Estação: Acesse informações abrangentes da estação, incluindo:
  • Instalações e recursos de acessibilidade
  • Layouts de plataforma e informações de trilhos
  • Disponibilidade de OV-fiets (aluguel de bicicletas)
  • Detalhes de localização e acesso

Recursos Adicionais

• Suporte a Múltiplos Idiomas: Informações disponíveis em holandês e inglês
• Consultas Flexíveis: Pesquise por nome da estação, código ou identificador UIC
• Fusos Horários: Tratamento adequado de fusos horários para estações internacionais
• Atualizações de Status: Acompanhe mudanças, atrasos e cancelamentos em tempo real

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes