wakatime-mcp 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 74f08cc25ca0fa9d0c8ceb77c2bd5580ca86259ddc5c308c7187baac9c679510
+  data.tar.gz: 49d4a4d19a04a9312fd5994ff1785ce1d555fd90f1d5e5f8c027f53d7e3f82c8
+SHA512:
+  metadata.gz: c3e1d3b19412e6267719b1c7007aab20ca3b04bf50963b5984100ab3785e698607e0ddb6a893a0c3e53428c8f9c584d2aa1932ebc62455ef803d73a485598f49
+  data.tar.gz: afc28672e872325ddd1442b4b8e82325e223608c19ac8be1b1e386a78153b1bcc6461ed1569d7937901f3b2785e7bdacf99ab5d8bab3469ab68f8d50fa6a7191

data/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.0.1] - 2026-01-21
+
+### Added
+- Initial release
+- WakaTime MCP server implementation in Ruby
+- `wakatime_summaries` tool - 指定期間の日次サマリを取得
+- `wakatime_today` tool - 今日のサマリを取得
+- Unit tests and integration tests
+- Support for timezone parameter
+- Support for project filtering
+
+[Unreleased]: https://github.com/geeknees/wakatime-mcp-rb/compare/v0.0.1...HEAD
+[0.0.1]: https://github.com/geeknees/wakatime-mcp-rb/releases/tag/v0.0.1

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,139 @@
+# 🚀 wakatime-mcp-rb
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+WakaTime MCP server の Ruby 実装です。WakaTime Summaries API をラップし、stdio 経由で MCP ツールを公開します。
+
+## 📋 概要
+
+主な機能:
+
+- 🔐 `WAKATIME_API_KEY` で認証
+- 📊 日次サマリと今日のサマリを公開
+- 💎 Ruby と mcp-rb を使用
+
+## 🚀 クイックスタート
+
+### インストール
+
+```bash
+gem install wakatime-mcp
+```
+
+### 実行
+
+```bash
+export WAKATIME_API_KEY="YOUR_API_KEY"
+wakatime_mcp
+```
+
+WakaTime API キーは [WakaTime Settings](https://wakatime.com/settings/account) から取得できます。
+
+## 🤖 MCP 設定
+
+Claude Desktop などの MCP クライアント設定例:
+
+```json
+{
+  "mcpServers": {
+    "wakatime": {
+      "command": "wakatime_mcp",
+      "env": {
+        "WAKATIME_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+## 🧰 利用可能なツール
+
+### `wakatime_summaries`
+
+指定期間の日次サマリを取得します。
+
+```json
+{
+  "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）。
+
+```json
+{
+  "tool": "wakatime_today",
+  "arguments": {
+    "project": "my-project",
+    "timezone": "Asia/Tokyo"
+  }
+}
+```
+
+パラメータ:
+- `project` (オプション): プロジェクト名でフィルタ
+- `timezone` (オプション): タイムゾーン (デフォルト: Asia/Tokyo)
+
+## ⚙️ 設定
+
+| 環境変数 | 説明 | 必須 |
+| --- | --- | --- |
+| `WAKATIME_API_KEY` | WakaTime API キー | ✅ |
+
+WakaTime API キーは [WakaTime Settings](https://wakatime.com/settings/account) から取得できます。
+
+## 🛠️ 開発
+
+### セットアップ
+
+```bash
+git clone https://github.com/yourusername/wakatime-mcp-rb.git
+cd wakatime-mcp-rb
+bundle install
+```
+
+### ローカルで実行
+
+```bash
+export WAKATIME_API_KEY="YOUR_API_KEY"
+./bin/wakatime_mcp
+```
+
+## 🧪 テスト
+
+```bash
+# 全てのテストを実行
+bundle exec rake test
+
+# または
+bundle exec rake
+```
+
+テストには以下のgemが使用されています:
+- minitest - テストフレームワーク
+- minitest-reporters - カラフルなテスト出力
+- webmock - HTTPリクエストのモック
+
+## 📚 参考
+
+- [WakaTime MCP (TypeScript版)](https://github.com/geeknees/wakatime-mcp)
+- [mcp-rb](https://github.com/funwarioisii/mcp-rb)
+- [WakaTime API Documentation](https://wakatime.com/developers)
+
+## 📝 ライセンス
+
+MIT

data/bin/json_schemer

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'json_schemer' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("json_schemer", "json_schemer")

data/bin/wakatime_mcp

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/wakatime_mcp/server"

data/lib/wakatime_mcp/server.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../wakatime_mcp"
+
+name "wakatime-mcp"
+version WakatimeMcp::VERSION
+
+tool "wakatime_summaries" do
+  description "WakaTime Summaries API を叩き、指定期間の日次サマリ(JSON)を返します。"
+  
+  argument :start, String, required: true, description: "YYYY-MM-DD"
+  argument :end, String, required: true, description: "YYYY-MM-DD"
+  argument :project, String, required: false, description: "プロジェクト名でフィルタ"
+  argument :timezone, String, required: false, description: "例: Asia/Tokyo"
+
+  call do |args|
+    WakatimeMcp.wakatime_get("users/current/summaries", {
+      start: args[:start],
+      end: args[:end],
+      project: args[:project],
+      tz: args[:timezone]
+    })
+  end
+end
+
+tool "wakatime_today" do
+  description "今日のサマリ(JSON)を返します（Asia/Tokyo をデフォルトにします）。"
+  
+  argument :project, String, required: false, description: "プロジェクト名でフィルタ"
+  argument :timezone, String, required: false, description: "例: Asia/Tokyo"
+
+  call do |args|
+    tz = args[:timezone] || "Asia/Tokyo"
+    ymd = WakatimeMcp.today_ymd(tz)
+    
+    WakatimeMcp.wakatime_get("users/current/summaries", {
+      start: ymd,
+      end: ymd,
+      project: args[:project],
+      tz: tz
+    })
+  end
+end

data/lib/wakatime_mcp.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "base64"
+require "date"
+
+module WakatimeMcp
+  VERSION = "0.0.1"
+
+  # WakaTime API helper
+  def self.wakatime_get(path, params = {})
+    api_key = ENV["WAKATIME_API_KEY"]
+    raise "環境変数 WAKATIME_API_KEY が未設定です（WakaTimeのAPI Key）。" unless api_key
+
+    uri = URI("https://api.wakatime.com/api/v1/#{path}")
+    uri.query = URI.encode_www_form(params.compact)
+
+    # WakaTime uses Basic auth with API key as username
+    auth = Base64.strict_encode64(api_key)
+    
+    req = Net::HTTP::Get.new(uri)
+    req["Authorization"] = "Basic #{auth}"
+    req["Accept"] = "application/json"
+
+    res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
+      http.request(req)
+    end
+
+    unless res.is_a?(Net::HTTPSuccess)
+      raise "WakaTime API error: #{res.code}\n#{res.body}"
+    end
+
+    res.body
+  end
+
+  # Get today's date in YYYY-MM-DD format for a given timezone
+  def self.today_ymd(timezone = "Asia/Tokyo")
+    # Ruby's Time with timezone support
+    time = Time.now.getlocal(timezone)
+    time.strftime("%Y-%m-%d")
+  rescue ArgumentError
+    # Fallback to UTC if timezone is invalid
+    Time.now.utc.strftime("%Y-%m-%d")
+  end
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification
+name: wakatime-mcp
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Masumi Kawasaki
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: mcp-rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+description: A Model Context Protocol server that exposes WakaTime summary tools via
+  stdio. Provides wakatime_summaries and wakatime_today tools for querying your coding
+  activity.
+email:
+- geeknees@gmail.com
+executables:
+- wakatime_mcp
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- bin/json_schemer
+- bin/wakatime_mcp
+- lib/wakatime_mcp.rb
+- lib/wakatime_mcp/server.rb
+homepage: https://github.com/geeknees/wakatime-mcp-rb
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/geeknees/wakatime-mcp-rb
+  source_code_uri: https://github.com/geeknees/wakatime-mcp-rb
+  changelog_uri: https://github.com/geeknees/wakatime-mcp-rb/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/geeknees/wakatime-mcp-rb/issues
+  documentation_uri: https://github.com/geeknees/wakatime-mcp-rb/blob/main/README.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: WakaTime MCP server implementation in Ruby
+test_files: []