🚀 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_KEY`	WakaTime API キー	✅

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リクエストのモック

📚 参考

📝 ライセンス

MIT

wakatime-mcp

Runtime