Flutter Skill MCP 服务器
使用说明(Markdown 格式)
-
项目简介
- Flutter Skill MCP 服务器是一个完整的后端服务,旨在通过 MCP 协议向 AI 客户端提供对 Flutter 应用的上下文、资源和功能访问能力。服务器负责资源托管、工具注册与执行、Prompt 模板的定义与渲染,并通过 JSON-RPC 进行请求/响应通信。支持会话管理、能力声明以及多种传输协议,以实现安全、可扩展的后端上下文服务。
-
主要功能点
- MCP 核心能力:实现对资源、工具和 Prompts 的注册、读取、执行与渲染,提供标准化的接口供客户端使用。
- JSON-RPC 通信:服务器通过 JSON-RPC 方式接收请求并返回响应或通知,兼容多种传输通道。
- 会话与能力声明:管理会话状态、声明服务器能力,并支持多客户端并发访问。
- 多传输协议支持:通过 STDIO、SSE、WebSocket 等传输方式与客户端进行通信,提升集成灵活性。
- 资源与工具管理:托管资源(Data/数据访问)、注册工具(API 调用外部功能)、以及定义与渲染 Prompt 模板,方便 LLM 进行上下文推理和操作执行。
- 安全与扩展:提供可扩展的能力,支持插件化工具、资源的权限控制与安全审计。
-
安装步骤(可选的多路径安装)
- 使用 npm 全局包安装(推荐用于快速接入)
- 使用 Homebrew/Docker 等平台包管理器安装
- 使用 Dart 运行本地服务器(需要 Flutter/Dart 环境)
- 详尽的本地运行和部署方式,请参考仓库内的安装与部署文档
-
服务器配置(MCP 客户端需要的最小信息) 配置示例(MCP 客户端读取的 JSON 配置,描述服务器名称、启动命令与参数): { "name": "flutter-skill", "command": "flutter-skill", "args": ["server"] } 注释说明:
- name: MCP 客户端用于标识该服务器的唯一名称,便于在多服务器场景中区分。
- command: 启动 MCP 服务器的命令名称,需在执行环境中可用(如全局安装的二进制、脚本等)。
- args: 启动命令的参数数组,本文档中的默认参数为 ["server"],用于启动标准 MCP 服务模式。 说明:该配置信息仅用于 MCP 客户端发现与连接,不要求客户端修改或了解服务器实现细节。
-
基本使用方法
- 启动服务器
- 通过提供的命令在支持的环境中运行,服务器将启动并等待 MCP 客户端的连接。
- 连接客户端
- MCP 客户端将使用上面的配置向服务器发起 JSON-RPC 请求,读取 Resources、调用 Tools、获取 Prompts 等。
- 使用资源、工具与 Prompts
- 客户端通过对资源/工具/提示的标准化接口,读取数据、执行外部功能、渲染对话模板,从而实现对 Flutter 应用的控制与上下文提供。
- 安全与扩展
- 服务器支持多会话与权限控制,便于在多代理/多应用场景中进行隔离与扩展。
- 启动服务器
-
额外信息
- MCP 服务器实现包含对资源、工具、Prompts 的管理能力,以及通过 JSON-RPC 的请求/响应机制进行通信。
- 项目内包含对多种安装方式的支持、以及 VSCode 插件、CLI、DevContainer 等生态,以方便开发、集成和部署。