# 🛼 MCP Server Roller Derby Rules

MCP (Model Context Protocol) server to access Roller Derby rules extracted from a PDF (French)

## Installation

```bash
npm install
```

## Usage

### Start the server

```bash
npm start
```

### Development mode (with auto-reload)

```bash
npm run dev
```

## Features

### Tools

1. **list_sections** - List all available sections
2. **get_section** - Get the content of a specific section
   - Available sections: `introduction`, `parametres`, `le-jeu`, `score`, `penalites`, `arbitrage`
3. **search_rules** - Search by keyword in the rules
   - Parameters:
     - `query`: search term
     - `section` (optional): specific section to search in

### Resources

- `derby://rules/complete` - Complete rules document
- `derby://rules/section/00-introduction` - Introduction section
- `derby://rules/section/01-parametres` - Parameters section
- `derby://rules/section/02-le-jeu` - The game section
- `derby://rules/section/03-score` - Score section
- `derby://rules/section/04-penalites` - Penalties section
- `derby://rules/section/05-arbitrage` - Officiating section

## Configuration

### Claude Desktop

Add this server to your Claude Desktop configuration:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`  
**Linux**: `~/.config/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "derby-rules": {
      "command": "node",
      "args": ["/absolute/path/to/mcpDerby/index.js"]
    }
  }
}
```

### GitHub Copilot (VS Code) Local path

1. Install the "GitHub Copilot" extension in VS Code
2. Open settings (Ctrl+, or Cmd+,)
3. Search for "MCP" or "Model Context Protocol"
4. Add a `mcp.json` in .vscode directory inside your project :

```json
{
  "servers": {
    "derby-rules": {
      "command": "node",
      "args": ["/absolute/path/to/mcpDerby/index.js"]
    }
  }
}
```

### ChatGPT Desktop

MCP support is not yet natively available in ChatGPT Desktop. You can:

1. **Use the OpenAI API** with an MCP-compatible client
2. **Copy-paste** content from markdown files in `output/`
3. **Use an MCP proxy** that exposes data via REST API

### Other MCP clients

For any MCP-compatible client, use:

**Command**: `node`  
**Arguments**: `["/absolute/path/to/mcpDerby/index.js"]`  
**Transport**: `stdio`

## Data structure

Rules are organized into:

- A complete file: `output/contenu-complet.md`
- Individual sections in: `output/sections/`

## Usage examples

### Search for "jammer" in all rules

```json
{
  "tool": "search_rules",
  "arguments": {
    "query": "jammer"
  }
}
```

### Get the penalties section

```json
{
  "tool": "get_section",
  "arguments": {
    "section": "penalites"
  }
}
```

### Read the complete resource

```
derby://rules/complete
```