How do I use Cinema Scheduler?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Cinema Scheduler Plan a schedule to watch both Godzilla and Perfect Days in Shinjuku today." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Cinema Scheduler

映画館の上映スケジュールをスクレイピングし、Claude Desktop からMCPツールとして利用できるシステム。

構成

パッケージ	説明
`@cinema-scheduler/shared`	共有コード（DB、型定義）
`@cinema-scheduler/scraper`	eiga.com スクレイパー
`@cinema-scheduler/mcp`	MCP サーバー
`@cinema-scheduler/inspector`	WebUI インスペクター

セットアップ

# 依存関係インストール
pnpm install

# ビルド
pnpm build

使い方

1. スクレイピング

# 東京エリアを3日分スクレイピング
pnpm scrape --area tokyo --days 3

# ドライラン（DB保存なし）
pnpm scrape --area tokyo --days 1 --dry-run

# 利用可能なエリア一覧
pnpm scrape --list-areas

2. Claude Desktop との連携

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cinema-scheduler": {
      "command": "node",
      "args": ["/path/to/cinema-scheduler/packages/mcp/dist/server.js"]
    }
  }
}

3. Inspector WebUI

pnpm inspector

http://localhost:3001 でMCPツールをブラウザからテストできます。

MCPツール

ツール	説明
`get_showtimes`	上映スケジュール検索
`list_theaters`	映画館一覧
`list_movies`	上映中映画一覧
`get_data_status`	データ状態確認
`optimize_schedule`	複数映画の最適上映順序

開発

# テスト
pnpm test

# 型チェック
pnpm typecheck

# リント
pnpm lint

ディレクトリ構造

cinema-scheduler/
├── packages/
│   ├── shared/      # 共有コード
│   ├── scraper/     # スクレイパー
│   ├── mcp/         # MCPサーバー
│   └── inspector/   # WebUI
├── data/            # SQLiteデータベース
└── .kiro/           # 仕様・ステアリングドキュメント