Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
pnpm install
pnpm build2
Register it in Claude Code
claude mcp add cinema-scheduler -- node /path/to/cinema-scheduler/packages/mcp/dist/server.jsReplace any placeholder paths in the command with the real path on your machine.
3
Make your agent remember this setup
cinema-scheduler's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Scrapes movie theater schedules from eiga.com
- Provides movie, theater, and showtime data to AI
- Calculates optimal viewing order for multiple movies
- Includes a WebUI inspector for testing tools
Tools 5
get_showtimesSearch for movie screening schedules.list_theatersList available movie theaters.list_moviesList movies currently showing.get_data_statusCheck the status of the scraped data.optimize_scheduleCalculate the optimal viewing order for multiple movies.Try it
→What movies are playing at theaters in Tokyo today?
→Find showtimes for the latest blockbuster movie near me.
→I want to watch three specific movies today, can you optimize my schedule to fit them all in?
→List all the theaters currently available in the database.
Original README from ysm1026/cinema-scheduler
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/ # 仕様・ステアリングドキュメント