English Français العربية

io.github.XWeaponX7/rundida-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

Running tools for AI agents: 92 calculators, 46 guides, marathon data, pace and HR zones.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @rundida/mcp-server
Claude Code 
claude mcp add rundida-mcp -- npx -y @rundida/mcp-server@1.2.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "rundida-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@rundida/mcp-server@1.2.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @rundida/mcp-server
  2. Quick Start
  3. Available Tools
  4. Example Usage
  5. About RunDida
  6. How It Works
  7. Requirements
  8. Links
  9. License

@rundida/mcp-server

MCP server for **RunDida** — running expertise for AI agents.

Ten tools that let Claude, Cursor or any MCP client compute paces, heart-rate zones, race predictions and marathon countdowns live, and query RunDida's full library: 99 running calculators, 56 training guides and 300+ marathon events (course, weather and registration data) — in English, Chinese and Japanese. Free, zero-config, no API key.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rundida": {
      "command": "npx",
      "args": ["-y", "@rundida/mcp-server"]
    }
  }
}
Claude Code
claude mcp add rundida -- npx -y @rundida/mcp-server
Cursor / Windsurf

Add to your MCP configuration:

{
  "rundida": {
    "command": "npx",
    "args": ["-y", "@rundida/mcp-server"]
  }
}

Available Tools

ToolTypeDescription
list_toolsDataBrowse all 99 running calculators with descriptions
get_toolDataGet details, FAQs, and sources for a specific tool
list_guidesDataBrowse all 46 running guides with descriptions
get_guideDataGet guide details, FAQs, and related tools
list_marathonsDataList 300+ marathon events with dates and locations
get_marathonDataGet marathon details including weather and course profile
calculate_paceComputeCalculate pace, time, or distance (provide any 2 of 3)
predict_raceComputePredict race times using Riegel formula + VO2max estimation
heart_rate_zonesComputeCalculate 5 HR training zones (Karvonen method)
marathon_countdownComputeGet countdown to a specific marathon event

Data tools fetch from the RunDida API with 30-minute caching. Compute tools run locally with zero latency — no API calls needed.

Example Usage

Ask your AI assistant:

  • "What's my marathon pace if I want to finish in 3:30?"
  • "Predict my marathon time based on my 10K of 45 minutes"
  • "What are my heart rate zones? I'm 32 with a resting HR of 52"
  • "How many days until the Tokyo Marathon?"
  • "Show me all running calculators related to nutrition"
  • "What running guides do you have about marathon training?"
  • "Tell me about the couch to 5K guide"

About RunDida

**RunDida** (跑滴答) is a free running tools platform for runners of all levels:

  • 90+ Interactive Calculators — Pace, heart rate zones, VO2max, race prediction, nutrition, gear sizing, weather impact, and more
  • 29 Marathon Countdowns — Live timers with race-day weather forecasts, course profiles, and training tools
  • Free JSON API — No authentication required, CORS enabled, OpenAPI 3.0 documented
  • Multi-language — English, Chinese (中文)
  • Embeddable Widgets — One-line iframe embed for any calculator

All tools are free, no account required. Try them at rundida.com.

How It Works

The computation tools use established running science formulas:

FormulaUsed InDescription
Riegel formulapredict_raceRace time prediction across distances
Jack Daniels methodpredict_raceVO2max estimation from race performance
Karvonen methodheart_rate_zonesHeart rate training zones from age and resting HR

Requirements

  • Node.js >= 18
  • Internet connection (data tools fetch from rundida.com)
ResourceURL
RunDida Websiterundida.com
API Documentationrundida.com/api
OpenAPI Specrundida.com/api/openapi.json
NPM Package@rundida/mcp-server

License

MIT

الأسئلة الشائعة

ما هو io.github.XWeaponX7/rundida-mcp؟

Running tools for AI agents: 92 calculators, 46 guides, marathon data, pace and HR zones.

كيف أثبّت io.github.XWeaponX7/rundida-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add rundida-mcp -- npx -y @rundida/mcp-server@1.2.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.XWeaponX7/rundida-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.XWeaponX7/rundida-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.XWeaponX7/rundida-mcp؟

ينشره XWeaponX7. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.