mcpField
F
fline

fline

远程服务
fline.sh云与基础设施01 周前更新

关于 fline

fline skills 提供操作指南,帮助 AI 编码应用在 fline 上准备、部署和管理项目,适用于 Claude Code、Codex、Cursor 等支持 Agent Skills 的应用。Claude Code 插件还会连接 fline 的 MCP 服务。

主要功能

  1. 01准备项目以便部署
  2. 02启动、更新和回滚应用
  3. 03使用数据库和域名
  4. 04诊断启动及运行问题
  5. 05分享前检查应用

适用场景

  1. 01首次上传前准备项目
  2. 02部署应用并管理后续更新
  3. 03排查启动失败或线上问题

MCP 相关

Claude Code 插件包含连接 fline MCP 服务的配置,并通过浏览器进行 OAuth 授权。通过其他方式安装的技能不包含该服务,需另行连接。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp.fline.sh/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

fline 技能

这些技能可教会你的 AI 编码应用(Claude Code、Codex、Cursor 及其他支持 Agent Skills 的应用)如何通过 fline 将项目上线。对于 Claude Code,此仓库还是一个可连接 fline MCP 服务的插件。

安装

应用方法
Claude Code,包括 Claude 桌面应用的 Code 标签页/plugin marketplace add smartline-ai/fline-skills,然后运行 /plugin install fline@fline
Codex、Cursor、Gemini CLI、VS Code 及其他应用npx skills add smartline-ai/fline-skills
手动安装将 skills/* 复制到 ~/.claude/skills/(Claude Code)或 ~/.agents/skills/(Codex 及其他应用)

Claude Code 插件附带 fline MCP 服务:输入 /mcp,选择 fline,然后选择 Authenticate,并在浏览器中批准 fline。通过其他方式安装时,技能本身不包含服务;请按照 fline 文档中的说明连接 fline,或让你的 AI 应用连接,这会加载 fline-connect。

你需要拥有 fline 账户。fline 目前处于私人测试阶段:请参阅获取账户。

它会发送什么,以及发送到哪里

这些技能只是指令;它们本身不会向任何地方发送内容。离开电脑的内容会通过 fline 的 MCP 服务 https://mcp.fline.sh/mcp 传输,而且只会在用户要求 fline 执行操作时发送:

  • 项目文件夹。 scripts/pack.sh 会将其打包为一份 .tar.gz 副本,排除 .git、node_modules、项目 .gitignore 忽略的内容,以及 .env 和密钥文件;随后 Agent 会将其上传到 fline 的存储空间。fline 会保留此副本,以便构建和运行应用。原始文件仍留在文件夹中。
  • **部分代码,发送给 OpenAI 制作的 AI 模型,**以便 fline 判断如何构建和运行应用。保存在 fline 上的密码和密钥不会发送给它。
  • 工具调用。 项目名称、设置名称、网址以及 fline 工具的其他参数。密码和密钥由用户在私密的 fline 页面中输入,不会通过聊天发送。例外情况是 Agent 已持有的密钥、由 Agent 生成的密钥,或用户粘贴到聊天中的密钥:set_env 会将该值发送给 fline,由 fline 保存,且不会再次显示。
  • 返回的内容。 项目状态、构建输出和应用的近期日志行,其中包含应用输出的任何内容。

登录通过浏览器中的 OAuth 完成;插件不持有任何密钥。在 fline 控制面板中断开连接后,设置会在 30 秒内生效。详情请参阅:隐私政策、条款、fline 当前的功能。

技能

技能涵盖内容
fline-connect将 fline 的 MCP 服务添加到 AI 应用、浏览器审批,以及会拒绝所有调用的账户状态
fline-prepare检查项目中阻碍其在 fline 上运行的问题,并在首次上传前修复,包括供 fline 检查的简易健康检查路由
fline-launch首次启动、更新、设置、重启和恢复到较早版本;包含 scripts/pack.sh
fline-database由 fline 创建并运行的 Postgres 或 Valkey、用户已在运行的数据库、SQLite 和磁盘上的文件
fline-domain用户拥有的网址:记录、检查和 48 小时的限制
fline-diagnose启动失败或在线应用出现异常时,应按什么顺序查看哪些内容,以及常见原因
fline-build-planfline.json:锁定计划、编辑计划、check_config、多个服务、预构建镜像、卷、健康检查路径
fline-share-check用户将应用的公开链接发送给任何人之前,应检查应用中的哪些内容

这些技能分为三组:使用 fline(connect、launch、database、domain、diagnose)、为 fline 准备项目(prepare、build-plan),以及确保分享安全(share-check)。

MCP 服务提供了提示词,为什么还需要技能

fline 的服务附带了七个包含这些流程的提示词。在 Claude Code 中,MCP 提示词是用户输入的斜杠命令;模型没有工具来获取提示词,因此服务的说明会指向 Agent 无法打开的流程。模型在技能描述与任务匹配时会自行加载技能。

技能中使用不带前缀的 fline 工具名称(create_project,而非 mcp__fline__create_project):插件提供的服务与用户自行添加的服务,其前缀有所不同。

目录结构

.claude-plugin/plugin.json        the plugin, including fline's MCP server
.claude-plugin/marketplace.json   a marketplace holding that one plugin
skills/<name>/SKILL.md            one directory per skill (Agent Skills format)
skills/fline-launch/scripts/      pack.sh, run by the agent, never read
tests/                            scenarios and the projects they run on

测试

  • claude plugin validate --strict . 用于检查清单文件。
  • bash skills/fline-launch/scripts/pack.sh <folder> 可在 macOS 自带的 bash 3.2 和 bsdtar 上运行,也可在 GNU tar 上运行。
  • tests/scenarios.md 包含六个场景及通过时应有的回答,由全新 Agent 在有无技能的情况下运行。 tests/make-fixtures.sh 会生成这六个场景所用的两个预置项目:一个 Node 商店和一个 Flask 跟踪器。

内容来源

此处的所有信息均基于 fline 自己的文档,尤其是 for-ai.md。此仓库从 fline 的主仓库发布;仅在此处进行的更改会在下次发布时被覆盖。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。