README

iRacing MCP

iRacing MCP is a Python-based project that integrates iRacing with the Model Context Protocol (MCP). It provides tools and resources to interact with iRacing data and build custom applications.

Features

Retrieve iRacing profile statistics.
More coming soon

Getting Started

Prerequisites

uv - Install here
iRacing account with legacy authentication (required) - Disable it here: https://oauth.iracing.com/accountmanagement/security

Installation

Clone the repository:

git clone https://github.com/musantro/iracing-mcp.git
cd iracing-mcp

Create environment with dependencies:
```
uv sync
```

Set up environment variables for iRacing credentials:

export IRACING_USERNAME="your_username"
export IRACING_PASSWORD="your_password"

Usage

Running the Server Standalone

To start the MCP server, run:

uv run server

Running the Server on VSCode

Add this to your settings.json (in mcp.servers):

"iracing": {
    "command": "path/to/your/uv",
    "args": [
        "--directory",
        "path/to/your/iracing-mcp",
        "run",
        "server"
    ],
    "env": {
        "IRACING_USERNAME": "your-username",
        "IRACING_PASSWORD": "your password"
    }
}

Development

Linting and Formatting

Use the following commands to lint and format the code:

make

Contributing

We welcome contributions! Follow these steps to contribute:

Fork the repository.
Create a new branch for your feature or bugfix.
Push your branch.
Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

iRacing MCP

README

iRacing MCP

Features

Getting Started

Prerequisites

Installation

Usage

Running the Server Standalone

Running the Server on VSCode

Development

Linting and Formatting

Contributing

License

Recommended Servers