Hoshin Kanri X-Matrix

Hoshin Kanri — MCP 服务

hoshin.app 背后的 MCP 服务：一个持续演进的 X-Matrix，你的 AI Agent 可以读取、质疑并更新它——其中包含 3 到 5 年期目标、年度目标、举措、KPI、它们之间的相关性、让它们持续运作的审查周期，以及一个给出明确判断而非模糊印象的完整度评分。

16 个工具 · 9 个引导式提示词 · 3 种传输方式 · MIT。

注册条目：io.github.wellknownmcp/hoshin-kanri · npm：hoshin-kanri-mcp

为什么要做这个

Agent 擅长执行工作，却不擅长判断哪些工作重要。缺少的不是更多记忆，而是结构化的战略记忆：一个包含象限、相关性和评分的对象，让 Agent 能回答“这项举措真的服务于某个既定目标吗？”，并在答案是否定时明确指出。

这个对象就是 X-Matrix，一种比这一切早了四十年的 Hoshin Kanri 工件。本服务通过 Model Context Protocol 将其开放出来。

安装

本地自主模式——数据不会离开你的设备

你的矩阵以纯 JSON 文件的形式保存在自己的磁盘上。无需账户、无需云服务、无遥测。这是 npm 包默认提供的可执行文件，正是有意如此。

{
  "mcpServers": {
    "hoshin-kanri": {
      "command": "npx",
      "args": ["-y", "hoshin-kanri-mcp"],
      "env": { "HOSHIN_DATA_DIR": "/path/to/your/data" }
    }
  }
}

HOSHIN_DATA_DIR 默认指向 ~/hoshin-data/。这些文件本身就是导出文件：易读、可比较差异、可纳入版本控制，完全归你所有。参见 docs/data-residency.md。

托管模式——OAuth 2.1，无需安装

claude.ai、Claude Desktop 和 Cursor 可直接连接到 https://hoshin.app/mcp。 使用动态客户端注册 + PKCE，因此无需粘贴令牌，也无需编辑配置文件——将该 URL 添加为连接器并完成授权即可。

{
  "mcpServers": {
    "hoshin-kanri": {
      "command": "npx",
      "args": ["-y", "-p", "hoshin-kanri-mcp", "hoshin-kanri-mcp-remote"],
      "env": { "AUTH_TOKEN": "hk_..." }
    }
  }
}

内容一览

工具和提示词的定义在设计上由各种传输方式共用，只有处理程序不同。若托管模式中有某个工具而本地模式没有，就会悄然使自主模式沦为二等选择。因此，保持一致是硬性规则，而非愿景——只有一个有意为之的例外，见下文说明。

工具

get_matrix_data · get_matrix_summary · get_matrix_completeness · list_objectives · update_element_status · add_idea · search_ideas · get_management_architecture · diagnose_theme_deployment · suggest_meeting_for_topic · share_matrix · create_matrix · upsert_element · set_correlation · get_cascade · set_matrix_parent

值得特别介绍的几个工具：

• get_matrix_completeness 会根据五项指标（覆盖率、相关性密度、孤立元素、端到端战略链、领先指标与滞后指标的平衡）给出 0–100 分，并附上具体建议。这正是让 Agent 真正发挥作用，而非一味迎合的关键。
• update_element_status 接受 external_ref，即实施该项举措的 Linear/Jira/GitHub 项目的 URL 或标识。战略留在这里，任务留在你的执行工具中，而 weekly_sync 提示词会引导 Agent 同步这两边的信息。
• create_matrix、upsert_element 和 set_correlation 允许 Agent 从零构建战略，并持续更新。
• get_cascade 会读取跨层级的部署情况：集团矩阵、其业务部门及各部门的站点。矩阵指向上一级矩阵（parent_matrix_id，也可稍后通过 set_matrix_parent 设置）；元素则指向其部署所对应的父矩阵元素（parent_element_id）。报告会针对每个层级列出下级承接的年度目标和举措、无人承接的目标和举措、没有上级支撑的下级目标，以及覆盖率。同一组织内，不允许出现循环，最多四个层级。

share_matrix 会发布一个可撤销、只读的矩阵公开页面。在本地模式下，此操作会被拒绝——这是有意为之：在主权模式下，你的数据不会泄露到云端，因此也就没有可供发布的数据。

提示词

weekly_sync（从问题跟踪工具的 MCP 拉取执行进度、更新状态、准备每周议程） · matrix_artifact（适用于会议室展示的交互式 X 矩阵） · strategic_review · deployment_diagnosis · indicator_balance · meeting_setup_guide · visual_matrix · export_data · idea_triage

开发

cd mcp-server
pnpm install
pnpm start:local    # sovereign JSON mode
pnpm start:stdio    # hosted API mode (AUTH_TOKEN, API_BASE_URL)
pnpm start          # Streamable HTTP (server-side; MCP_PORT, API_BASE_URL, OAUTH_ISSUER)

无需客户端即可对本地传输进行冒烟测试：

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"smoke","version":"1"}}}' \
  | HOSHIN_DATA_DIR=/tmp/hoshin-smoke node index-local.js 2>/dev/null

stdout 仅传输 JSON-RPC；日志和启动横幅会输出到 stderr。

此仓库包含 MCP 服务及其规范。托管式 Web 应用（Next.js、Prisma、OAuth 2.1 授权服务器）属于独立的闭源代码库——这里的 MIT 许可代码就是你要运行的内容，也是你可以在运行前审查的代码。

欢迎提交问题和拉取请求，英语或法语均可。

了解更多

• 什么是 Hoshin Kanri？
• 精益管理中的 AI：从引领开始
• 模型上下文协议

MIT——代码只是商品；你的战略不是。