Metadata-Version: 2.4
Name: bixi-mcp
Version: 0.0.1
Summary: MCP server for the Bixi API
Author-email: Renaud Bourassa <rbourassadenis@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/renaudb/bixi-mcp
Project-URL: Repository, https://github.com/renaudb/bixi-mcp
Project-URL: Issues, https://github.com/renaudb/bixi-mcp/issues
Keywords: bixi,bike-share,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: bixi-sdk
Requires-Dist: mcp[cli]
Requires-Dist: pydantic
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: pyright; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Dynamic: license-file

Bixi MCP Server
================

[![License](https://img.shields.io/github/license/renaudb/bixi-mcp.svg)](LICENSE)
[![pre-commit](https://github.com/renaudb/bixi-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/renaudb/bixi-mcp/actions/workflows/ci.yml)

## Description

A local (stdio) [MCP](https://modelcontextprotocol.io) server exposing the [BIXI Montréal](https://bixi.com) bike-share API, via [bixi-sdk](https://github.com/renaudb/bixi), as tools for MCP clients.

## Tools

- `list_stations` — list all Bixi stations currently in service.
- `list_rides` — list the current member's ride history (paginated via `offset`).

## Installation

The server can be run directly with [`uvx`](https://docs.astral.sh/uv/guides/tools/) — no separate install step required.

## Configuration

The server authenticates with your Bixi account using the `BIXI_USERNAME` and `BIXI_PASSWORD` environment variables.

Example configuration for an MCP client (e.g. Claude Desktop `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "bixi": {
      "command": "uvx",
      "args": ["bixi-mcp"],
      "env": {
        "BIXI_USERNAME": "your-username",
        "BIXI_PASSWORD": "your-password"
      }
    }
  }
}
```

## Development

```bash
pip install -e .[dev]
pre-commit install
```
