核心用法
Ikuzo 定位为地图驱动的旅行探索与规划平台,通过 MCP 协议提供完整的地点管理与行程编排能力。核心功能覆盖三大场景:
地图与地点管理
- 创建多层级地图(
maps_create),支持所有权与共享权限 - 地点(Spot)是核心数据单元,含 GPS 坐标、类型标签(如餐厅、景点)、状态(如"必去"/"备选")、时段标签及重复提醒
- 强大的空间查询:
spots_nearby支持半径搜索(默认10km,最大500km),spots_box支持地图框选,跨所有可访问地图聚合结果
智能行程规划
- 旅行计划(Travel)采用"日+地点"双层级结构:
steps_add可插入日期分隔(type="day")或具体地点(type="spot") - 支持
orderKey调整顺序,实现拖拽式排序逻辑
时效性与筛选
momentFrom/To筛选特定日期范围内的活动(如花期、祭典)period标签支持"春/夏/秋/冬"等季节性分类fields参数可精简返回字段,优化 token 消耗
显著优点
1. 空间计算能力突出:500km 最大半径+跨地图聚合,远超常规 LBS 应用
2. 数据模型灵活:状态-类型-时段三维标签体系,适应从日常探店到季节性旅行的多元场景
3. 行程结构清晰:日-地点层级天然匹配实际旅行节奏,非简单列表堆砌
4. CDN 图片处理:支持动态裁剪参数,便于多端适配
潜在局限
1. 认证依赖外部配置:Bearer token 需从 TOOLS.md 或用户配置获取,未说明轮换机制
2. 软删除设计:spots_delete 为可恢复删除,长期数据清理策略不明
3. 配额监控有限:quota 工具存在但细节未披露,高频率调用存在不确定性
4. 生态封闭性:图片 CDN 域名(ik.offbeatjapan.org)暗示与日本小众旅行内容的绑定,通用性存疑
适合人群
- 深度自由行用户:需管理数百+地点、跨多次旅行的长期规划
- 季节限定内容追踪者:樱花、红叶等时效性活动管理
- 小团队协作:共享地图支持多人共建目的地库
常规风险
- 位置隐私:GPS 坐标上传与跨地图聚合搜索涉及敏感位置数据
- API 稳定性:MCP 协议层错误处理、限流策略未在文档中详述
- 数据可迁移性:导出/备份机制未提及,存在平台锁定风险