# 🧗‍♂️ Climbing Grade Converter MCP Server

A specialized Model Context Protocol (MCP) server that enables LLMs (like Claude) to accurately convert climbing grades across different rating systems using a data-driven approach.

## 🛠️ Tech Stack

- **Python 3.11+**
- **FastMCP** (MCP Python SDK)
- **Pydantic** (Data Validation)
- **uv** (High-performance Python package & environment manager)

## 🚀 Quick Start (Linux/WSL)

**1. Prerequisites**  
Ensure you have `uv` installed in your Linux distribution:
```Bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
**2. Installation**  
Clone the repository and sync dependencies:
```Bash
git clone https://github.com/yychentw/free-climbing-grade-converter-mcp.git
cd free_climbing_grade_converter_mcp
uv sync
```
**3. Verification**  
Test the server logic manually in your terminal:
```Bash
uv run main.py
```

## ⚙️ Configuration for Claude Desktop
To use this tool in **Claude Desktop (Windows)** via **WSL**, add the following entry to your `claude_desktop_config.json` (**Note:** Replace `/home/user/...` with the absolute path to your project directory in WSL.):

```JSON
{
  "mcpServers": {
    "climbing-converter": {
      "command": "wsl",
      "args": [
        "-d", "Ubuntu", 
        "-e", "bash", "-l", "-c", 
        "cd /home/user/free_climbing_grade_converter_mcp && uv run main.py"
      ]
    }
  }
}
```

## 📖 Usage Examples

Once connected, you can ask Claude:
- "I just climbed a 6a+ in France. What is that in YDS?"
- "Convert V3 to the French grading system."
- "What climbing systems do you currently support?"

## 📂 Project Structure

- `main.py`: The core MCP server logic and tool definitions.
- `climbing_grades.json`: The source-of-truth database for grade mappings.
- `pyproject.toml`: Project metadata and dependency management.