项目简介

该 MCP 服务器专为简化 FileMaker Web Viewer 插件（Widget）的开发流程而设计。它通过提供标准化的工具，帮助开发者快速初始化一个新的 FileMaker Widget 项目仓库，并能根据用户的项目需求生成用于指导大型语言模型（LLM）代理完成后续开发工作的详细提示。

主要功能点

项目仓库初始化: 自动克隆项目模板，设置基础文件结构，并安装 JavaScript 依赖。
生成代理提示: 根据用户提供的项目意图、技术栈等信息，生成结构化、详细的提示内容，供 LLM 代理理解项目要求并进行开发。
集成 FileMaker 通信服务: 包含一个基础的 FileMakerService 模板，用于在 Widget 中与 FileMaker 进行数据交互（通过执行 FileMaker 脚本）。

克隆仓库:

git clone https://github.com/Nuosis/widget-setup-server.git
cd widget-setup-server

创建并激活虚拟环境:

uv venv
source .venv/bin/activate # Windows 用户使用: .venv\Scripts\activate

MCP 客户端需要知道如何启动此服务器进程并与其通信。在您的 MCP 客户端配置文件中，需要添加一个服务器条目，指定服务器名称、启动命令及其参数。

服务器名称 (server name): 'widget-setup'
启动命令 (command): 指定用于启动 Python 脚本的可执行文件路径，例如 '/path/to/.venv/bin/python' 或 '/path/to/.local/bin/uv'。
命令参数 (args): 指定传递给启动命令的参数，用于执行服务器脚本。例如，如果您使用 'uv' 启动，参数可能包括 '--directory /path/to/widget-setup-server run widget_setup_server.py'。如果您直接使用 'python'，参数可能只是 'widget_setup_server.py'。确保路径是服务器脚本所在的实际路径。

客户端将使用这些信息在需要时启动服务器进程，并通过标准输入/输出来进行 JSON-RPC 通信（默认使用 Stdio 传输）。

一旦服务器在 MCP 客户端中配置并连接成功，您就可以通过调用其提供的工具来使用其功能。

连接服务器: 您的 MCP 客户端会根据配置连接到名为 'widget-setup' 的服务器。
初始化项目: 调用 'initialize_repo' 工具，并提供项目名称 ('projectName') 和项目存放的绝对路径 ('projectDir') 作为参数。服务器将执行仓库克隆、依赖安装等初始化操作，并返回结果及项目路径。
- 'initialize_repo' 参数: 'projectName' (项目名称), 'projectDir' (项目存放的绝对路径)。
生成代理提示: 在项目初始化完成后，根据项目需求调用 'get_prompt' 工具。您需要提供关于 widget 意图、FileMaker 文件信息、技术栈选择等参数。服务器将返回一个包含详细提示文本的结果，您可以将其提供给 LLM 代理进行后续的编码工作。
- 'get_prompt' 参数: 'widgetIntention' (widget 意图), 'projectName' (项目名称), 'fileName' (FileMaker 文件名), 'fileMakerPath' (FileMaker 文件路径), 'scriptName' (通信脚本名称), 'techStack' (技术栈列表), 'useTypeScript' (是否使用 TypeScript), 'stateLibrary' (状态管理库), 'stylePaths' (样式/示例文件路径列表)。具体参数说明请参考服务器的工具能力声明或文档。

通过以上步骤，您可以利用此 MCP 服务器自动处理 FileMaker Widget 项目的繁琐前期设置，并将 LLM 代理集成到开发流程中。