内容
片拍摄计划工具
<p align="center">
<img src="assets/mascot/photo-scout.png" alt="照片拍摄计划工具吉祥物：一只像素艺术风格的鸟，携带相机和拍摄计划" width="280">
</p>
一款适用于摄影旅行和专业照片拍摄制作的Claude兼容MCP服务器和技能套件。
## 两种计划模式
### 户外和天体摄影旅行
- 解析地点并规范化GPS坐标
- 计算月相、升降时间、海拔/方位、银河核心位置、金色/蓝色时段和天文学黑暗时间
- 查看每小时云层、可见度、风、湿度、降水情况
- 解释提供的Bortle/SQM测量值，而不发明场地评级
- 比较观景点、估计路线、发现附近住宿并推荐相机设置
### 管理照片拍摄制作
- 将目标转化为创意简报和视觉方向
- 计划情绪板、地点、拍摄清单、人才和工作人员
- 制定预算、设备计划、服装/道具清单和拍摄日程表
- 跟踪许可证、保险、模特/财产释放和用途权利
- 在分发制作手册之前运行最终准备检查
## 技能套件
技能遵循AI工作搜索集合使用的模块化模式：一个协调工作流程加上专注的专业技能，可以独立触发。
| 技能 | 责任 |
|---|---|
| `plan-photo-production` | 协调完整的制作手册 |
| `develop-creative-brief` | 目标、受众、交付成果、用途、审批 |
| `build-photo-mood-board` | 视觉参考、色板、灯光、造型规则 |
| `scout-photo-location` | 创意契合度、光线、通行、许可证、后勤、备份 |
| `create-photo-shot-list` | 所需覆盖范围、设置分组、优先级、时间安排 |
| `coordinate-talent-crew` | 角色、预订、责任、旅行、联系方式 |
| `build-photo-call-sheet` | 电话、时间表、餐食、移动、天气、安全 |
| `manage-shoot-budget` | 估算、承诺、实际支出、应急、差异 |
| `plan-photo-equipment` | 相机、灯光、摄影器材、电源、存储、冗余 |
| `manage-wardrobe-props` | 外观、道具、产品、连续性、退货 |
| `check-shoot-permits-releases` | 许可证/释放/保险问题发现和状态 |
## MCP工具
| 工具 | 用途---|---|
| `resolve_location` | 将地点名称转换为候选坐标 |
| `get_astronomy` | 每日太阳/月亮窗口和相位 |
| `get_sky_timeline` | 通过会话获取月亮和银河位置 |
| `get_weather` | 每小时拍摄条件预报 |
| `assess_dark_sky` | 解释提供的Bortle或SQM数据 |
| `compare_viewpoints` | 排名候选地点 |
| `plan_route` | 估计路线距离和持续时间 |
| `find_nearby_lodging` | 发现附近的住宿地点 |
| `recommend_camera_settings` | 特定于设备的起始设置 |
| `calculate_shoot_budget` | 计算类别总和、税、应急和差异 |
| `build_call_sheet` | 验证时间表数学和人员级别冲突 |
| `generate_release_checklist` | 生成特定案件的法律准备检查清单 |
| `validate_shoot_readiness` | 将制作障碍与警告分开 |
| `create_shooting_plan` | 生成可打印的户外实地计划 |
## 安装
需要Node.js 20或更新版本。首先克隆并构建项目：
```bash
git clone https://github.com/chenyuan99/photo-shoot-planner.git
cd photo-shoot-planner
npm ci
npm run build
```
### 在Codex中安装技能
Codex在`~/.agents/skills`中发现个人技能。复制技能文件夹到那里可以在每个工作区中使用。
macOS或Linux：
```bash
mkdir -p ~/.agents/skills
cp -R skills/. ~/.agents/skills/
```
Windows PowerShell：
```powershell
New-Item -ItemType Directory -Force "$HOME/.agents/skills"
Copy-Item -Recurse -Force "skills/*" "$HOME/.agents/skills/"
```
对于仅限项目的安装，请将文件夹复制到目标存储库内的`.agents/skills/`。Codex会自动检测技能更改；如果新技能未出现，请重启Codex。
这些技能可以在此步骤后提供仅限指令的计划。如果您还想要实时位置、天气、天文学、路由、预算、拍摄日准备工具，请在下面配置MCP服务器。
### 配置MCP服务器
在本地运行服务器以验证构建：
```bash
npm test
npm start
```
要将本地服务器注册到Codex，请将示例路径替换为此检出的绝对路径：
```bash
codex mcp add photo-shoot-planner -- node /absolute/path/photo-shoot-planner/dist/index.js
codex mcp list
```
ChatGPT桌面应用程序、Codex CLI和IDE扩展程序共享Codex MCP配置。在添加服务器后重启活动客户端，然后使用`/mcp`确认已连接。
对于Claude Desktop开发，请配置相同的绝对服务器路径：
```json
{
"mcpServers": {
"photo-shoot-planner": {
"command": "node",
"args": ["C:/absolute/path/photo-shoot-planner/dist/index.js"]
}
}
}
```
## 使用技能
x中，运行`/skills`或在提示符中键入`$`以浏览已安装的技能。您可以显式调用技能或自然地描述任务，让Codex选择匹配的技能。
使用协调技能进行完整的专业制作：
```text
$plan-photo-production 在布鲁克林计划一场六人编辑时尚拍摄，日期为9月18日。预算上限为12,000美元。制作简介、拍摄清单、工作人员计划、预算、设备清单、拍摄日程、发布检查清单和准备报告。
```
在需要专注的交付成果时调用专家：
```text
$build-photo-call-sheet 为产品拍摄创建拍摄日程表，从上午8:00到下午6:00，包含两个工作室设置、45分钟午餐和30分钟罢工。
```
```text
$scout-photo-location 比较三个地点进行黄金时段肖像拍摄。评估创意契合度、通行、许可证、天气风险和备用选项。
```
自然语言请求也有效：
- “比较下周末在Sequoia和Death Valley进行银河摄影，使用的是一台Nikon Z30相机。”
- “为为期两天的商业产品拍摄制定预算和设备计划。”
- “审核此拍摄日程表是否存在时间冲突、缺失的休息时间和准备障碍。”
为了获得更强的结果，请包括拍摄类型、目标、日期、交付成果、团队规模、预算、设备限制、使用权、截止日期以及已知的安全或可访问性需求。非关键的缺失细节可以保留为`TBD`，并附上负责人和截止日期。
## 打包为Claude扩展
```bash
npm install -g @anthropic-ai/mcpb
npm run build
mcpb validate manifest.json
mcpb pack
```
从Claude Desktop -> 设置 -> 扩展 -> 高级设置 -> 安装扩展，安装生成的`.mcpb## 数据和安全说明
服务器向Open-MeteoStreetMap Nominatim、和Overpass发送坐标查询。这些公共服务可能会限制速率或不可用。天文学本地的。
预报、关闭、许可证、劳动法、保险、使用权、野雾、潮汐、和法律要求必须由相关部门或合格的专业人员验证。工具输出是计划支持，而不是法律、安全、劳动或保险建议。
## 模式
可重用的合约位于`schemas/`中，用于拍摄计划、创意简报、拍摄清单、预算和拍摄日程表。工具输入使用Zod生成的JSON模式验证。
## 许可证
MIT
