项目简介 Fluent MCP (Model Context Protocol) 服务器是ServiceNow Fluent SDK的后端实现，它将ServiceNow的开发工具和AI辅助开发环境连接起来。通过实现Model Context Protocol，该服务器允许开发者和AI代理使用自然语言与Fluent命令交互，并访问ServiceNow的API规范、代码片段和开发指南等资源。它支持通过Stdio协议与多种MCP客户端（如VSCode Agent模式、Claude Code、Cursor、Windsurf、Gemini CLI）进行通信。
主要功能点
- 全面的ServiceNow SDK CLI支持： 涵盖所有原生ServiceNow SDK命令，包括认证、初始化、构建、部署、转换、依赖管理、下载、清理和打包等。
- 增强的SDK信息访问： 提供'sdk_info'命令以获取SDK版本、帮助和调试信息。
- ServiceNow实例认证管理： 支持'basic'或'oauth'认证方式，并通过'manage_fluent_auth'工具进行认证配置。
- 丰富的资源访问能力： 托管并提供各种元数据类型（如ACL、业务规则、客户端脚本、表、UI动作等）的API规范、代码片段和使用说明。
- 可定制的Prompt模板： 支持定义和渲染Prompt模板，例如用于"用Fluent编码"的开发指南。
- 会话管理： 维护工作目录等会话信息，确保命令在正确的上下文环境中执行。
安装步骤 该服务器通常作为NPM包发布。在您的开发环境中，需要安装Node.js (22.15.1+) 和 npm (11.4.1+)。您可以通过 'npx' 命令直接运行，无需全局安装：
```
npx @modesty/fluent-mcp
```
服务器配置 MCP客户端需要配置MCP服务器的启动命令及其参数才能建立连接。以下是常见MCP客户端配置'fluent-mcp'服务器的示例，您需要将这些配置添加到您的MCP客户端设置中（通常是JSON格式）：
- 配置参数说明：
  - 服务器名称 ('fluent-mcp')：您可以为服务器指定一个易于识别的名称，例如 'fluent-mcp'。
  - 命令 ('command')：'npx'（用于执行Node.js包的命令）。
  - 参数 ('args')：'["-y", "@modesty/fluent-mcp"]'（执行'fluent-mcp'包的参数）。
  - 环境变量 ('env')：可选的环境变量，例如：
    - 'SN_INSTANCE_URL'：您的ServiceNow实例URL（必需，用于认证）。
    - 'SN_AUTH_TYPE'：认证类型，可以是'basic'或'oauth'。
基本使用方法
1. 认证ServiceNow实例： 在与ServiceNow实例交互之前，您需要配置认证信息。
  - 创建一个新的认证别名： '请使用 manage_fluent_auth 工具为实例 <您的ServiceNow实例URL> 创建一个名为 myFluentMcpAuth 的认证配置'
  - 列出现有的认证配置： '请使用 manage_fluent_auth 工具显示所有认证配置'
  - 切换默认认证配置： '请使用 manage_fluent_auth 工具将 myFluentMcpAuth 设置为默认认证配置'
2. 项目设置： 您可以创建一个新的Fluent应用项目，或转换现有ServiceNow应用。
  - 创建一个新项目： '请使用 init_fluent_app 工具在目录 <您的工作目录> 下创建一个用于 <您应用的功能描述> 的Fluent项目'
  - 转换现有应用（通过sys_id或本地路径）： '请使用 init_fluent_app 工具将 sys_id 为 <应用的sys_id> 的现有 scoped 应用转换为目录 <您的工作目录> 中的Fluent项目' '请使用 init_fluent_app 工具将位于 <scoped应用路径> 的现有 scoped 应用转换为目录 <您的工作目录> 中的Fluent项目'
  - 继续现有项目： '请使用 init_fluent_app 工具初始化目录 <您的工作目录> 中的Fluent项目' 或 '请将工作目录设置为 <您的工作目录> 以操作Fluent项目'
3. 访问API规范： 您可以轻松获取各种ServiceNow元数据类型的API规范。
  - 例如，获取业务规则的API规范： '请给我 business-rule 的API规范'
4. 获取代码片段： 您可以请求特定元数据类型的代码片段。
  - 例如，获取ACL的代码片段： '请给我 acl 的代码片段'
5. 获取操作说明： 您可以获取特定元数据类型的开发和最佳实践说明。
  - 例如，获取脚本包含的操作说明： '请给我 script-include 的操作说明'

关键词

信息