一个MCP服务器和AI技能套件，将ServiceNow Fluent SDK（@servicenow/sdk）功能、API规范、代码片段和安全审查带入AI辅助开发环境中。

主要特色

• 17 MCP 工具 — 13 个 ServiceNow SDK CLI 命令工具（sdk_info、init、build、deploy、transform、dependencies、download、clean、pack、explain、explain、query、cicd_fluent_app、cicd_fluent_test）以及 4 个资源/认证工具（[get-api-spec、get-snippet、get-instruct、check_auth_status）。
• 75 ServiceNow 元数据类型 — 打包的 API 规范（sn-spec://）、创作指令（sn-instruct://）、可运行的片段（sn-snippet://）和工作流提示（coding_in_fluent、create_custom_ui）。
• AI 代理技能 — 内置技能（fluent-cli、fluent-security-review、fluent-general-review、fluent-perf-review和 fluent-domain-separation-review），可作为 Claude Code、Codex、Copilot 及其他技能代理的插件安装。
• 懒惰自动认证 — 首次使用时解析并缓存匹配SN_INSTANCE_URL的SDK认证配置文件。

Fluent MCP Server

An MCP server and AI skill suite that brings ServiceNow Fluent SDK (@servicenow/sdk) capabilities, API specifications, code snippets, and security reviews to AI-assisted development environments.

Built for @servicenow/[email protected].

Key Features

• 18 MCP Tools — 14 ServiceNow SDK CLI command tools (sdk_info, init, build, deploy, transform, dependencies, download, clean, pack, explain, query, cicd_fluent_app, cicd_fluent_test, fluent_exec_script) plus 4 resource/auth tools (get-api-spec, get-snippet, get-instruct, check_auth_status).
• 76 ServiceNow Metadata Types — Packaged API specs (sn-spec://), authoring instructions (sn-instruct://), runnable snippets (sn-snippet://), and workflow prompts (coding_in_fluent, create_custom_ui).
• AI Agent Skills — Built-in skills (fluent-cli, fluent-security-review, fluent-general-review, fluent-perf-review, and fluent-domain-separation-review) installable as a plugin for Claude Code, Codex, Copilot, and other skill-enabled agents.
• Lazy Auto-Authentication — Resolves and caches an SDK auth profile matching SN_INSTANCE_URL on first use.
• Explicit Working Directory Resolution — Resolves project paths in strict order: workingDirectory argument → session (init_fluent_app) → FLUENT_MCP_WORKING_DIR → actionable error. Never guesses from process.cwd().
• Dual-Era MCP Protocol — Serves both current and legacy MCP protocol revisions over stdio from a single handler set, with zero server-initiated requests.

---

MCP Setup

Requirements: Node.js >=22.23.2 and npm >=10.9.8.

Add @modesty/fluent-mcp to your MCP client configuration:

{
  "mcpServers": {
    "fluent-mcp": {
      "command": "npx",
      "args": ["-y", "@modesty/fluent-mcp"],
      "env": {
        "FLUENT_MCP_WORKING_DIR": "/absolute/path/to/your/fluent-project",
        "SN_INSTANCE_URL": "https://your-instance.service-now.com",
        "SN_AUTH_TYPE": "oauth"
      }
    }
  }
}

Client Config Locations:

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Code CLI: claude mcp add fluent-mcp -- npx -y @modesty/fluent-mcp
• VS Code Copilot: .vscode/mcp.json (uses "mcp": { "servers": { ... } } instead of "mcpServers")
• Cursor / Windsurf / Gemini CLI: Add under mcpServers in your client’s MCP settings file

Environment Variables