Climbing Grade Converter 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:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Installation
Clone the repository and sync dependencies:

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:

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.):

{
  "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.