🚀 wakatime-mcp-rb

WakaTime MCP server の Ruby 実装です。WakaTime Summaries API をラップし、stdio 経由で MCP ツールを公開します。

📋 概要

主な機能:

• 🔐 WAKATIME_API_KEY で認証
• 📊 日次サマリと今日のサマリを公開
• 💎 Ruby と mcp-rb を使用

🚀 クイックスタート

インストール

gem install wakatime-mcp

実行

export WAKATIME_API_KEY="YOUR_API_KEY"
wakatime_mcp

WakaTime API キーは WakaTime Settings から取得できます。

🤖 MCP 設定

Claude Desktop などの MCP クライアント設定例:

{
  "mcpServers": {
    "wakatime": {
      "command": "wakatime_mcp",
      "env": {
        "WAKATIME_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

🧰 利用可能なツール

wakatime_summaries

指定期間の日次サマリを取得します。

{
  "tool": "wakatime_summaries",
  "arguments": {
    "start": "2025-01-01",
    "end": "2025-01-07",
    "project": "my-project",
    "timezone": "Asia/Tokyo"
  }
}

パラメータ:

• start (必須): 開始日 (YYYY-MM-DD)
• end (必須): 終了日 (YYYY-MM-DD)
• project (オプション): プロジェクト名でフィルタ
• timezone (オプション): タイムゾーン (例: Asia/Tokyo)

wakatime_today

今日のサマリを取得します（デフォルトは Asia/Tokyo）。

{
  "tool": "wakatime_today",
  "arguments": {
    "project": "my-project",
    "timezone": "Asia/Tokyo"
  }
}

パラメータ:

• project (オプション): プロジェクト名でフィルタ
• timezone (オプション): タイムゾーン (デフォルト: Asia/Tokyo)

⚙️ 設定

WakaTime API キーは WakaTime Settings から取得できます。

🛠️ 開発

セットアップ

git clone https://github.com/yourusername/wakatime-mcp-rb.git
cd wakatime-mcp-rb
bundle install

ローカルで実行

export WAKATIME_API_KEY="YOUR_API_KEY"
./bin/wakatime_mcp

🧪 テスト

# 全てのテストを実行
bundle exec rake test

# または
bundle exec rake

テストには以下のgemが使用されています:

• minitest - テストフレームワーク
• minitest-reporters - カラフルなテスト出力
• webmock - HTTPリクエストのモック

📚 参考

• WakaTime MCP (TypeScript版)
• mcp-rb
• WakaTime API Documentation

📝 ライセンス

MIT