Vilnius Transport

🚀 Vilnius Transport MCP Server

This project is an implementation of a Model Context Protocol (MCP) server that provides access to Vilnius public transport data, enabling Large Language Models (LLMs) to obtain real-time bus information. It demonstrates how to extend the capabilities of LLMs through the MCP standard.

Model Context Protocol (MCP) is a standard that allows Large Language Models (LLMs) to securely access external tools and data. MCP enables LLMs to:

• Access real-time or local data
• Invoke external functions
• Interact with system resources
• Maintain a consistent tool interface

This project implements an MCP server, offering Vilnius public transport data tools for large language models, enabling them to answer questions about bus stops and routes.

The server provides the following MCP tools:

💻 Usage Examples

Basic Usage

• find_stops: Search for public intersections by name

{
    "name": string; // The full or partial name of the stop
}

• find_closest_stop: Find the nearest public transport stop based on given coordinates

{ 
    "coordinates": string; // Format: "latitude, longitude" (e.g., "54.687157, 25.279652")
}

Advanced Usage

To add the MCP server to your Claude development environment, add the following configuration to the claude_desktop_config.json file:

{
    "mcpServers": {
        "vilnius_transport": {
            "command": "uv",
            "args": [
                "--directory",
                "path/Vilnius-Transport-MCP-Server/src/vilnius_transport_mcp",
                "run",
                "transport.py"
            ]
        }
    }
}

⚠️ Important Note

Please adjust the directory path to match your local installation.

To run the client:

uv run client.py path/src/vilnius_transport_mcp/transport.py