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 客户端发现与连接,不要求客户端修改或了解服务器实现细节。
  • 基本使用方法

    1. 启动服务器
      • 通过提供的命令在支持的环境中运行,服务器将启动并等待 MCP 客户端的连接。
    2. 连接客户端
      • MCP 客户端将使用上面的配置向服务器发起 JSON-RPC 请求,读取 Resources、调用 Tools、获取 Prompts 等。
    3. 使用资源、工具与 Prompts
      • 客户端通过对资源/工具/提示的标准化接口,读取数据、执行外部功能、渲染对话模板,从而实现对 Flutter 应用的控制与上下文提供。
    4. 安全与扩展
      • 服务器支持多会话与权限控制,便于在多代理/多应用场景中进行隔离与扩展。
  • 额外信息

    • MCP 服务器实现包含对资源、工具、Prompts 的管理能力,以及通过 JSON-RPC 的请求/响应机制进行通信。
    • 项目内包含对多种安装方式的支持、以及 VSCode 插件、CLI、DevContainer 等生态,以方便开发、集成和部署。

服务器信息