flownato-mcp

Flownato MCP

一个用于移动端 UI/UX 设计研究的远程只读 Model Context Protocol 服务。它专为产品设计师和开发者打造，让兼容 MCP 的助手（Claude、Cursor、Codex、Windsurf 等）能够访问 Flownato 收录的真实移动应用屏幕、用户流程和 UI 模式，并确保每个回答都有已发布屏幕作为依据。

• 端点： https://agent.flownato.com/mcp（Streamable HTTP）
• 身份验证： OAuth 2.1 授权码流程，搭配 PKCE。浏览器会打开 Flownato 登录页面和只读授权确认页。无需粘贴 API 密钥。
• 访问权限： 每个已登录的 Flownato 账户都可以使用所有工具。免费账户的权限与网站上相同：可查看 flownato.com 标记为免费的完整流程，以及其他所有流程的前 3 个屏幕。高级账户可查看所有屏幕。
• 网站： https://www.flownato.com/mcp

功能

Flownato 记录了 Swiggy、Zepto、BookMyShow、redBus 和 Nykaa 等真实移动应用，并发布经过审核的屏幕、完整流程和 UI 模式分类。MCP 服务让助手能够搜索并比较这些资料，而不是猜测界面是什么样子。

它可以通过引用资料回答以下典型问题：

• “杂货应用在结账的配送时段步骤中是如何处理的？”
• “展示不同预订应用中的电话号码输入屏幕。”
• “比较 Cricbuzz 和 FanCode 的引导流程。”
• “哪些应用使用底部抽屉来选择商店？”

工具

工具	用途
whoami	报告已验证身份的会员信息、该会员级别可查看的内容以及客户端。
search_ui_library	为研究问题查找具体流程示例。
search_ui_screens	按屏幕搜索，并精确匹配界面文本。
analyze_ui_pattern	在可选的应用或类别范围内，统计一种屏幕模式、UI 元素、流程模式或流程操作。
explore_ui_patterns	在你还不确定要分析哪种模式时，发现反复出现的模式。
compare_ui_flows	比较两个或三个指定应用中同一产品环节的流程。
inspect_app_library	汇总某个应用已发布的内容、模式、元素和流程。
check_ui_presence	在指定范围内进行有证据支持的有无检查。
inspect_library_coverage	分页查看已发布内容清单。
inspect_ui_resources	根据返回的 resourceRef 对象，精确检索对应发布版本中的后续内容。
get_screen_image	在其他工具提供资源 ID 后，内联返回已发布的屏幕图像。

所有工具均为只读。结果会引用作为依据的具体流程和步骤标识符；模式计数仅用于描述，绝不会被表述为最佳实践。

连接

Claude Code 插件

该插件会安装 MCP 服务和 flownato-ui-research 技能，指导助手何时查询真实应用流程以及如何引用资料：

/plugin marketplace add flownato/flownato-mcp
/plugin install flownato@flownato

同一仓库还包含 Cursor（.cursor-plugin/）和 Codex（.codex-plugin/）的插件清单。该技能位于 skills/flownato-ui-research/SKILL.md。

仅使用 MCP 服务

在支持远程 mcpServers 配置的客户端中，使用：

{
  "mcpServers": {
    "flownato": {
      "type": "http",
      "url": "https://agent.flownato.com/mcp"
    }
  }
}

Claude Code：

claude mcp add --transport http flownato https://agent.flownato.com/mcp

首次使用时，客户端会在浏览器中打开 https://api.flownato.com/oauth/authorize。使用 Flownato 账户登录并批准只读访问权限。令牌有效期较短；除非你撤销授权，否则令牌会在后台自动刷新。

发现文档：

• 受保护资源元数据：https://agent.flownato.com/.well-known/oauth-protected-resource/mcp
• 授权服务器元数据：https://api.flownato.com/.well-known/oauth-authorization-server

访问权限和限制

计划	MCP 返回内容
未登录	端点会返回包含 OAuth 发现元数据的 401，客户端会据此打开 Flownato 登录页面。注册账户免费。
免费账户	可使用全部 11 个工具。flownato.com 上标记为免费的 Journey（每个应用最多 3 个）会返回所有屏幕。其他 Journey 会返回前 3 个屏幕，其余屏幕的返回结果会带有 locked: true，且不包含资源 ID 和图片 URL。每个结果都包含一个 access 区块，其中列出已锁定屏幕的数量和升级链接；对于已锁定的屏幕，get_screen_image 会返回 PREMIUM_REQUIRED。
Premium	可使用全部 11 个工具及完整资源库。

两个级别的使用量均受默认安全限制约束，每个 UTC 日最多调用 500 次工具。

提示词、参数和结果均不会被存储。屏幕截图 URL 采用签名，且有效期很短；获取图片时，图片端点会重新检查会员资格。

隐私和范围

服务仅读取已发布的产品目录：经过审核、不可变更且已应用隐私脱敏的版本。它无法访问原始爬取数据、模型输出或其他用户的账户。它会回答 UI 和产品设计研究相关问题，并拒绝处理无关请求。

源代码

此仓库介绍托管服务，并包含其插件清单和技能。服务本身属于 Flownato 的私有产品代码库（Python、FastAPI），并非开源。

Marketplace 元数据

lhm.plugin.json 声明了现有 LobeHub 列表的类别、远程端点和全部 11 个 MCP 工具架构。其类别为 developer（在 LobeHub 上显示为 Developer Skills），体现了它在 UI/UX 设计和产品开发中的用途。

端点要求在协议初始化和工具发现之前完成 OAuth 授权。未通过身份验证的请求返回 401 是预期行为；请使用上文的受保护资源元数据开始登录。仅凭未通过身份验证的连接，目录爬虫无法发现工具列表。

该服务目前仅提供工具，不提供 MCP 提示词模板或 MCP 资源。返回的 resourceRef 对象是传递给 inspect_ui_resources 的参数，并非 MCP resources/list 能力中的条目。请确保 Marketplace 声明与服务的实际能力一致。

上方的公开徽章支持 LobeHub 对 README 声明状态的检查。条件允许时，优先采用此公开验证途径。更新此公开列表并不构成向目录授予私有 GitHub 仓库读写权限的理由。

已完成验证的维护者可以使用官方 @lobehub/market-cli（Node.js 22 或更高版本）更新现有列表：

# Sign in to LobeHub, then check existing GitHub verification:
npx -y @lobehub/market-cli login
npx -y @lobehub/market-cli github status

# Requires ownership verification; run after reviewing lhm.plugin.json:
npx -y @lobehub/market-cli plugin update --dir "$PWD"

连接任何 GitHub 账户之前，请先检查请求的权限。如果认领或更新操作要求授予广泛的 repo 或 workflow 权限，请勿启用该连接，并向 LobeHub 请求范围更小的验证方式。

工具签名变更时，请先从经过身份验证的服务的 tools/list 响应中刷新 tools，再发布。除非服务已实现 prompts 和 resources，否则请将它们留空。此次元数据修正的列表版本仍为 1.0.0，不代表服务有新版本发布。每次更新后，请检查公开列表。

链接

• 产品：https://www.flownato.com
• MCP 页面：https://www.flownato.com/mcp
• 模式库：https://www.flownato.com/patterns
• 联系方式：[email protected]