Tampere Bus MCP Server

Tampere Bus MCP Server

By tlaukkanen GitHub

Nysse bus tracking MCP server for LLM AI agents

Overview

What is Nysse MCP Server?

Nysse MCP Server is a Model Context Protocol (MCP) server designed to provide AI agents with access to real-time bus traffic information for Tampere's public transport system.

How to use Nysse MCP Server?

To use the Nysse MCP Server, clone the repository, install the dependencies, set up the necessary environment variables, and run the server using Node.js.

Key features of Nysse MCP Server?

  • Search for bus stops by name.
  • Get real-time information about upcoming bus arrivals at specific stops.
  • Access to a complete database of bus stops in the Tampere region.

Use cases of Nysse MCP Server?

  1. AI assistants answering questions about bus schedules.
  2. Integration with applications that require public transport data.
  3. Development and testing of AI agents in a simulated environment.

FAQ from Nysse MCP Server?

  • What are the prerequisites for running the server?

You need Node.js 18 or higher and optionally access credentials for the Waltti GTFS-RT API.

  • Can I run the server without real API credentials?

Yes! You can use simulated data for development and testing.

  • How do I find the next bus at a specific stop?

Use the findNextBus tool with the stop name as a parameter.

Content

Tampere Bus MCP Server

This is a Model Context Protocol (MCP) server that provides tools for AI agents to access bus traffic information for Tampere's public transport system. This enables AI assistants to answer questions like "When is the next bus stopping at Tuotekatu bus stop?"

Features

  • Search for bus stops by name
  • Get real-time information about upcoming bus arrivals at specific stops
  • Access to complete Tampere region bus stop database

Prerequisites

  • Node.js 18 or higher
  • Access credentials for the Waltti GTFS-RT API (optional for development)

Setup for VS Code as NPX MCP Server

Add to your MCP servers:

{
  "mcpServers": {
    "nysse-bus-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "nysse-mcp-server"
      ],
      "env": {
        "WALTTI_CLIENT_ID": "YOUR_CLIENT_ID_HERE",
        "WALTTI_CLIENT_SECRET": "YOUR_CLIENT_SECRET_HERE"
      }
    }
  }
}

Running the Server with inspector

Add the WALTTI credentials to package.json command line or to your environment variables and build and run with inspector task:

npm run inspector

Available Tools

The server provides the following MCP tools for AI agents:

License

ISC

No tools information available.
No content found.