Fitness MCP Server

筋トレ（BIG3中心）とランニング記録管理のためのMCPサーバーです。

🎯 プロジェクト目標

• 筋トレ: ベンチプレス100kg到達（現在95kg、体重72kg）
• ランニング: ハーフマラソン出場（7/12）、将来的にフルマラソン
• 完成期限: 2025年8月まで

🛠️ 技術スタック

• 言語: Go 1.23.4
• アーキテクチャ: クリーンアーキテクチャ
• データベース: SQLite（ローカル、ファイルベース）
• MCPライブラリ: mcp-go
• 開発手法: TDD + 軽量DDD

📁 プロジェクト構造

fitness-mcp-server/
├── cmd/mcp/              # MCPサーバーのエントリーポイント
├── internal/
│   ├── application/      # アプリケーション層
│   │   ├── command/      # コマンド（書き込み操作）
│   │   └── query/        # クエリ（読み込み操作）
│   ├── domain/           # ドメイン層
│   │   ├── strength/     # 筋トレドメイン
│   │   └── running/      # ランニングドメイン
│   ├── infrastructure/   # インフラ層
│   └── interface/        # インターフェース層
├── data/                 # SQLiteデータベースファイル
├── docker-compose.yml    # Docker Compose設定
├── Dockerfile           # Docker設定
└── Makefile            # 開発用コマンド

🚀 クイックスタート

前提条件

• Docker & Docker Compose
• Go 1.23+ （ローカル開発時）
• Make （オプション、コマンド簡略化のため）

1. リポジトリのクローン

git clone <repository-url>
cd fitness-mcp-server

2. 開発環境のセットアップ

# Makefileを使用する場合
make dev-setup

# 直接実行する場合
./docker-run.sh build

3. MCPサーバーの起動

# Dockerで起動
make run
# または
./docker-run.sh run

# ローカルで起動（要Go環境）
make build
./mcp

4. 動作確認

# 全テスト実行
make docker-test

# 記録テスト
make test-record

# クエリテスト  
make test-query

📋 使用可能なMCPツール

MCPサーバーは以下のツールを提供します：

1. record_training - トレーニング記録

筋トレセッションを記録します。

{
  \"jsonrpc\": \"2.0\",
  \"id\": 1,
  \"method\": \"tools/call\",
  \"params\": {
    \"name\": \"record_training\",
    \"arguments\": {
      \"date\": \"2025-06-14\",
      \"exercises\": [
        {
          \"name\": \"ベンチプレス\",
          \"category\": \"Compound\",
          \"sets\": [
            {
              \"weight_kg\": 95,
              \"reps\": 8,
              \"rest_time_seconds\": 180,
              \"rpe\": 8
            }
          ]
        }
      ],
      \"notes\": \"調子良好\"
    }
  }
}

2. get_personal_records - 個人記録取得

個人記録（PR）を取得します。

{
  \"jsonrpc\": \"2.0\",
  \"id\": 2,
  \"method\": \"tools/call\",
  \"params\": {
    \"name\": \"get_personal_records\",
    \"arguments\": {
      \"exercise_name\": \"ベンチプレス\"  // オプション、指定しない場合は全エクササイズ
    }
  }
}

3. get_trainings_by_date_range - 期間別トレーニング取得

指定期間のトレーニング履歴を取得します。

{
  \"jsonrpc\": \"2.0\",
  \"id\": 3,
  \"method\": \"tools/call\",
  \"params\": {
    \"name\": \"get_trainings_by_date_range\",
    \"arguments\": {
      \"start_date\": \"2025-06-01\",
      \"end_date\": \"2025-06-30\"
    }
  }
}

🔧 MCPクライアント接続設定

自動設定（推奨）

ローカルバイナリを使用する場合:

# ローカルでビルド & Claude Desktop設定
make setup-claude-local

Dockerを使用する場合:

# Dockerイメージビルド & Claude Desktop設定
make setup-claude-docker

設定確認:

make check-claude-config

手動設定

Claude Desktop での設定

Claude Desktopの設定ファイル（config.json）に以下を追加：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  \"mcpServers\": {
    \"fitness-mcp-server\": {
      \"command\": \"docker\",
      \"args\": [
        \"run\",
        \"--rm\",
        \"-i\",
        \"-v\",
        \"/path/to/fitness-mcp-server/data:/app/data\",
        \"fitness-mcp-server_fitness-mcp\"
      ],
      \"env\": {
        \"MCP_DATA_DIR\": \"/app/data\"
      }
    }
  }
}

注意: /path/to/fitness-mcp-serverは実際のプロジェクトパスに置き換えてください。

VS Code MCP Extension での設定

VS CodeのMCP拡張機能を使用する場合：

{
  \"mcp.servers\": {
    \"fitness-mcp-server\": {
      \"command\": \"./mcp\",
      \"args\": [],
      \"cwd\": \"/path/to/fitness-mcp-server\"
    }
  }
}

💻 開発用コマンド

Makefileコマンド一覧

# ヘルプ表示
make help

# 開発環境
make dev-setup      # 開発環境セットアップ
make docker-dev     # 開発モード（シェル）起動
make build          # ローカルビルド
make clean          #

... [View full README on GitHub](https://github.com/Hiroshi0900/fitness-mcp-server#readme)