ikuzo

Ikuzo 是一款专为旅行规划与地图管理设计的 MCP (Model Context Protocol) 技能，通过标准化的 JSON-RPC 2.0 协议与 ikuzo.app 云端服务深度集成，为用户提供完整的地理位置管理解决方案。

核心用法方面，Ikuzo 提供四大功能模块。地图管理支持创建和编辑个人地图作为地点容器；地点管理允许精细化标记 spot，包括 GPS 坐标、状态标签（如"Ikuzo!"优先级或"待访问"）、时间段规划及图片关联；旅行计划支持多日程行程创建；步骤编排则可将具体地点按天组织，构建结构化 itinerary。其空间查询能力尤为突出，支持半径搜索（最大 500 公里）和边界框查询，结合状态、类型、时间等多维度过滤器实现精准地点发现。

显著优点体现在架构安全性与功能丰富度的平衡。作为纯文档型 MCP 技能，它不含任何可执行代码，完全消除了代码注入风险。功能上支持灵活的字段筛选机制，可通过 fields 参数精确控制返回数据量以降低 token 消耗。与 Ikuzo 平台原生数据的直接对接，也确保了地图数据的实时同步与持久化存储。

潜在局限性包括严格依赖 ikuzo.app 在线服务，无网络环境将完全失效。作为 T3 级社区来源项目（个人开发者维护），长期维护稳定性不及企业级产品。此外，所有操作需通过 Bearer Token 认证，用户需自行承担凭证管理责任。

目标用户主要为深度旅行爱好者、自由行规划者、地理标记收集者及需要管理共享地图的团队用户。对于经常规划多日行程、整理目的地信息或建立个人地点知识库的用户，该技能提供了远超普通笔记工具的地理信息组织能力。

使用风险方面，除网络服务可用性风险外，最核心的是身份验证凭证安全管理。Bearer Token 泄露可能导致地图数据被未授权访问。建议用户在安全网络环境下使用，定期轮换 Token，并充分了解 ikuzo.app 的隐私政策以确保符合数据保护要求。

核心用法

Ikuzo 是一款面向旅行规划与地点探索的 MCP 技能，通过标准化 JSON-RPC 2.0 协议与 ikuzo.app 官方 API 通信。核心功能分为三大模块：

地图与地点管理

• maps_list/create/get 管理个人地图空间
• spots_list/nearby/box 支持多维度筛选（状态、类型、时段、地理位置）
• spots_create/update/delete 维护地点信息，含 GPS 坐标、评分、图片、提醒等元数据

智能旅行规划

• travels_create 创建行程后，通过 steps_add 以「天」为单位组织日程
• 支持混合编排：日间标题 (type="day") 与具体地点 (type="spot") 灵活组合

高效数据获取

• fields 参数精简返回字段，降低 Token 消耗
• momentFrom/To 筛选季节性活动，适合花期、祭典等时效性探索

显著优点

1. 零依赖安全架构：纯 Markdown 文档型技能，无可执行代码，攻击面极小
2. 官方 API 直连：数据流经 ikuzo.app 官方端点，非第三方代理，隐私可控
3. 地理智能：spots_nearby 支持 500km 半径跨地图搜索，自动按距离排序
4. 开放生态：MCP 标准协议，可与 Claude 等 AI 助手深度集成

潜在局限

• 功能边界：仅覆盖 ikuzo.app 已有功能，无法替代专业导航或实时交通
• 网络依赖：所有操作需在线连接官方 API，无本地缓存机制
• 认证门槛：需用户自行配置 Bearer Token，新手入门存在学习成本
• 平台锁定：行程数据存储于 ikuzo.app，导出自由度受限

适合人群

• 深度旅行规划者（需要跨地图整合多目的地）
• 地点收藏爱好者（咖啡馆、摄影点、小众景点管理）
• 季节性活动追踪者（樱花、红叶、市集等时效性探索）
• 已使用 ikuzo.app 的现有用户，希望通过 AI 对话简化操作

常规风险

• Token 泄露：Bearer Token 若配置不当可能被日志记录，建议存于 Claude 配置而非对话
• API 可用性：依赖 ikuzo.app 服务稳定性，极端情况可能出现单点故障
• 数据持久化：spots_delete 为软删除，但长期依赖需确认服务商数据策略