git clone https://github.com/moma1992/smartcity-mcp.git
cd smartcity-mcp

# 依存関係のインストール
uv sync

# 環境変数の設定
cp .env.example .env
# .env ファイルを編集してAPIキーを設定

{
  "mcpServers": {
    "yaizu-smartcity": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/smartcity-mcp",
        "run",
        "python",
        "-m",
        "yaizu_mcp.server"
      ]
    }
  }
}

# MCP Inspector で開発サーバー起動
uv run mcp dev yaizu_mcp/server.py

# 直接実行（STDIOモード）
uv run python yaizu_mcp/server.py

# テスト実行
uv run python tests/test_mcp_integration.py

# ビルドと起動
docker compose -f deploy/docker/docker-compose.yml up -d

# ログ確認
docker compose -f deploy/docker/docker-compose.yml logs -f

# ビルド
docker build -t yaizu-mcp -f deploy/docker/Dockerfile .

# タグ付け & プッシュ
docker tag yaizu-mcp <registry>.azurecr.io/yaizu-mcp:latest
docker push <registry>.azurecr.io/yaizu-mcp:latest

# Databricks CLI インストール
brew tap databricks/tap
brew install databricks

# 認証設定
databricks auth login --host <workspace-url>

# シークレットの設定
databricks secrets put-secret yaizu-demo yaizu-api-key
databricks secrets put-secret yaizu-demo yaizu-api-email
databricks secrets put-secret yaizu-demo yaizu-api-password

# ワークスペースへファイルをアップロード
databricks workspace import /Workspace/Users/<email>/mcp-yaizu-demo/app.py \
  --file app.py --format AUTO --overwrite
databricks workspace import /Workspace/Users/<email>/mcp-yaizu-demo/app.yaml \
  --file app.yaml --format AUTO --overwrite
databricks workspace import /Workspace/Users/<email>/mcp-yaizu-demo/requirements.txt \
  --file requirements.txt --format AUTO --overwrite
databricks workspace import-dir yaizu_mcp \
  /Workspace/Users/<email>/mcp-yaizu-demo/yaizu_mcp --overwrite

# アプリのデプロイ
databricks apps deploy mcp-yaizu-demo \
  --source-code-path /Workspace/Users/<email>/mcp-yaizu-demo

databricks apps list                    # アプリ一覧
databricks apps get mcp-yaizu-demo      # 状態確認
databricks apps start mcp-yaizu-demo    # 開始
databricks apps stop mcp-yaizu-demo     # 停止
databricks apps logs mcp-yaizu-demo     # ログ確認

smartcity-mcp/                          ← Databricks Apps source-code-path
├── app.py                              - Databricks Apps エントリーポイント
├── app.yaml                            - Databricks Apps 設定（シークレット参照）
├── requirements.txt                    - pip依存関係
├── yaizu_mcp/                          # MCPサーバー本体
│   ├── server.py                       #   サーバー実装 (FastMCP)
│   └── scraper.py                      #   APIカタログスクレイパー
├── deploy/
│   └── docker/                         #   Docker / exaBase用
│       ├── Dockerfile
│       ├── docker-compose.yml
│       └── docker-entrypoint.py
├── scripts/                            # データ処理スクリプト
├── tests/                              # テスト
├── data/                               # API仕様・ドキュメント
│   ├── api_specs/                      #   48個のJSON API仕様書
│   ├── documentation/                  #   PDFドキュメント
│   └── openapi/                        #   OpenAPI仕様書 (YAML)
├── docs/                               # ドキュメント
├── config.yaml                         # API設定
├── pyproject.toml                      # プロジェクト設定
├── uv.lock                             # 依存関係ロック
├── .env.example                        # 環境変数テンプレート
├── CLAUDE.md                           # Claude Code 開発ガイド
└── README.md