git-fit 0.22.0 → 0.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f9fda747ee0bdc1b1d6588bce636576cb8e371ea0ae36b2bcfedd377a516891
-  data.tar.gz: e19094889528196ead4715706a46fe035516d219ba2c69264cf32e4fc0820da6
+  metadata.gz: 05e915997e2a8843c5a47a964ff957134529c0712a2dd0743bd9f71828c87d3d
+  data.tar.gz: 96307ebf14dd9c1a37fa8615552d0daccc34218d6c2ff99ec6bfaad0621e5954
 SHA512:
-  metadata.gz: a3fec0c7cfe0f51d7087698900585e480b9ce52d73aa6a8238cfa2493d5500e9d20e93087dda785da91844b3099ea1c4d36b4e642dbd867187d94843ae63b466
-  data.tar.gz: b98ec2e23dc34c3c5694d4627c6ae12a153a2b185d76f0f9567903c2e39a4ff6bb7995ff928e4b17ef4978cdd0a03485e38ae41ef17d9f95bf63f16870d2324b
+  metadata.gz: 4b2e303432bab61591e5cc2835f3978574b21357f71bad88c37801c90614bc6f19f0f809cf7136c02b0d6e45d391aa6a76a1caeedd7666b2b69f5894d41f553f
+  data.tar.gz: 37090a85b6374f2ce0ee85b51c89b0bfc2ff6fbbf6d2a26c217ef4a16649480f78205b2d5abed165d3307763c464baae3c5d1f6e7144fc86aeb2a0c186e7751a

data/lib/git-fit.rb

@@ -90,7 +90,9 @@ require_relative 'git_fit/install/actions'
 require_relative 'git_fit/cli/install_cli'
 require_relative 'git_fit/cli/purge_cli'
 require_relative 'git_fit/cli/gh_cli'
+require_relative 'git_fit/mcp'
 require_relative 'git_fit/cli/export'
+require_relative 'git_fit/cli/mcp'
 require_relative 'git_fit/cli/import_cli'
 require_relative 'git_fit/cli/geo_cli'
 require_relative 'git_fit/strava_web/file_check'

data/lib/git_fit/cli/mcp.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'mcp'
+
+module GitFit
+  class McpCLI < Thor
+    desc 'serve', 'Start the MCP stdio server (read-only workouts data for AI clients)'
+
+    no_commands do
+      def git_fit_config
+        @git_fit_config ||= GitFit::Config.new(options[:config])
+      end
+    end
+
+    def serve
+      config = git_fit_config
+      server = GitFit::MCP.build_server(config)
+      ::MCP::Server::Transports::StdioTransport.new(server).open
+    rescue StandardError => e
+      say_status :error, "MCP server failed: #{e.message}", :red
+      exit 1
+    end
+  end
+end

data/lib/git_fit/cli.rb

@@ -23,6 +23,9 @@ module GitFit
     desc 'export SUBCOMMAND', 'Export activities to various formats'
     subcommand 'export', ExportCLI
 
+    desc 'mcp serve', 'Start the MCP stdio server (read-only workouts data for AI clients)'
+    subcommand 'mcp', McpCLI
+
     desc 'version', 'Show version'
     def version
       puts "git-fit v#{GitFit::VERSION}"

data/lib/git_fit/mcp/tools.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'sequel'
+require 'mcp'
+
+module GitFit
+  module MCP
+    # 只读 MCP tools —— expose 本地 workouts DB 给 AI 客户端（Claude/Code/opencode 等）。
+    # 数据已公开（Pages 站点），无隐私增量；SQLite readonly 打开。
+    #
+    # 输出格式约定：query_activities 使用与 insights 摘要一致的紧凑行
+    # （run_id | 日期 类型 距离 时长 HR 爬升），供 get_activity 下钻。
+    module Tools
+      ACTIVITY_COLUMNS = %i[
+        run_id name distance moving_time elapsed_time sport_category sport_type
+        start_date start_date_local location_country summary_polyline
+        average_heartrate max_heartrate average_cadence max_cadence
+        average_power max_power average_temperature calories average_speed
+        elevation_gain elevation_loss elevation_min elevation_max steps source
+      ].freeze
+
+      module_function
+
+      def db(config)
+        Sequel.sqlite(config.db_path, readonly: true)
+      end
+
+      def activity_line(row)
+        parts = [row[:run_id].to_s, row[:start_date_local].to_s[0, 10], row[:sport_category].to_s]
+        parts << format('%.1fkm', row[:distance] / 1000.0) if row[:distance]
+        parts << "#{(row[:moving_time] / 60).round}min" if row[:moving_time]
+        parts << "HR#{row[:average_heartrate].round}" if row[:average_heartrate]
+        parts << "asc#{row[:elevation_gain].round}m" if row[:elevation_gain]
+        parts.join(' | ')
+      end
+    end
+
+    class QueryActivitiesTool < ::MCP::Tool
+      tool_name 'query_activities'
+      description '查询运动活动列表（按日期范围/运动类型过滤，返回最近的紧凑摘要行）。' \
+                  '行格式：run_id | 日期 | 类型 | 距离 | 时长 | HR | 爬升。'
+
+      input_schema(
+        properties: {
+          from_date: { type: 'string', description: '起始日期 YYYY-MM-DD（含）', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+          to_date: { type: 'string', description: '结束日期 YYYY-MM-DD（含）', pattern: '^\\d{4}-\\d{2}-\\d{2}$' },
+          sport: { type: 'string', description: '运动类型（ride/run/hike/walk/swim/workout/other）' },
+          limit: { type: 'integer', description: '返回条数上限（1-500）', default: 50 },
+        },
+      )
+
+      class << self
+        def call(server_context:, from_date: nil, to_date: nil, sport: nil, limit: 50)
+          db = GitFit::MCP::Tools.db(server_context[:config])
+          rows = db[:activities].order(Sequel.desc(:start_date_local)).limit(2000).all
+          rows = rows.select { |r| r[:start_date_local].to_s[0, 10] >= from_date } if from_date
+          rows = rows.select { |r| r[:start_date_local].to_s[0, 10] <= to_date } if to_date
+          rows = rows.select { |r| r[:sport_category] == sport } if sport && sport != 'all'
+          rows = rows.first(limit.to_i.clamp(1, 500))
+          lines = rows.map { |r| GitFit::MCP::Tools.activity_line(r) }
+          body = lines.empty? ? '无匹配活动' : "#{rows.size} 条匹配：\n#{lines.join("\n")}"
+          ::MCP::Tool::Response.new([{ type: 'text', text: body }])
+        ensure
+          db&.disconnect
+        end
+      end
+    end
+
+    class GetActivityTool < ::MCP::Tool
+      tool_name 'get_activity'
+      description '按 run_id 获取单个活动的全字段详情。run_id 来自 query_activities。'
+
+      input_schema(
+        properties: {
+          run_id: { type: 'string', description: '活动 ID（如 garmin_cn_12345678）' },
+        },
+        required: ['run_id'],
+      )
+
+      class << self
+        def call(run_id:, server_context:)
+          db = GitFit::MCP::Tools.db(server_context[:config])
+          row = db[:activities].first(run_id: run_id)
+          unless row
+            return ::MCP::Tool::Response.new(
+              [{ type: 'text', text: "活动不存在：#{run_id}\n  Fix: 先用 query_activities 查询可用 run_id" }],
+              error: true,
+            )
+          end
+          ::MCP::Tool::Response.new([{ type: 'text', text: JSON.pretty_generate(
+            GitFit::MCP::Tools::ACTIVITY_COLUMNS.to_h { |k| [k, row[k]] },
+          ) }])
+        ensure
+          db&.disconnect
+        end
+      end
+    end
+
+    class GetStatsTool < ::MCP::Tool
+      tool_name 'get_stats'
+      description '获取全量统计摘要：summary（全历史累计）/ monthly（按月）/ yearly（按年）/ streaks（连续天数）/ activity_types。' \
+                  '注意 summary 是全历史累计，当期对比请看 monthly/yearly 分组行。'
+
+      input_schema(properties: {})
+
+      class << self
+        def call(server_context:)
+          db = GitFit::MCP::Tools.db(server_context[:config])
+          stats = GitFit::Export::Calculator.new(db: db).call
+          ::MCP::Tool::Response.new([{ type: 'text', text: JSON.pretty_generate(stats) }])
+        ensure
+          db&.disconnect
+        end
+      end
+    end
+  end
+end

data/lib/git_fit/mcp.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative 'mcp/tools'
+
+module GitFit
+  module MCP
+    module_function
+
+    # 构建 MCP server（stdio transport 由 CLI 层启动）。
+    def build_server(config)
+      ::MCP::Server.new(
+        name: 'git-fit-workouts',
+        version: GitFit::VERSION,
+        tools: [QueryActivitiesTool, GetActivityTool, GetStatsTool],
+        server_context: { config: config },
+      )
+    end
+  end
+end

data/lib/git_fit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GitFit
-  VERSION = '0.22.0'
+  VERSION = '0.23.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git-fit
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.23.0
 platform: ruby
 authors:
 - Lax
@@ -247,6 +247,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
 description: A git extension CLI for aggregating, managing, and exporting fitness
   activity data from multiple sources (Garmin, Strava, Keep, etc.)
 email:
@@ -275,6 +289,7 @@ files:
 - lib/git_fit/cli/gh_cli.rb
 - lib/git_fit/cli/import_cli.rb
 - lib/git_fit/cli/install_cli.rb
+- lib/git_fit/cli/mcp.rb
 - lib/git_fit/cli/purge_cli.rb
 - lib/git_fit/cli/strava.rb
 - lib/git_fit/cli/sync.rb
@@ -332,6 +347,8 @@ files:
 - lib/git_fit/llm/errors.rb
 - lib/git_fit/llm/prompts.rb
 - lib/git_fit/llm/template.rb
+- lib/git_fit/mcp.rb
+- lib/git_fit/mcp/tools.rb
 - lib/git_fit/parser.rb
 - lib/git_fit/parser/base.rb
 - lib/git_fit/parser/fit.rb