Fluent-MCP

Fluent-MCP

MCP server providing AI-assisted access to ServiceNow Fluent SDK commands, API specs, and snippets.

15
Stars
1
Forks
15
Releases

Overview

Fluent MCP Server brings the ServiceNow Fluent SDK capabilities into AI-assisted development environments via the Model Context Protocol. It enables natural language interaction with Fluent SDK commands, API specifications, code snippets, and development resources. Core capabilities include a Resources catalog (100+ resources across 35+ metadata types such as API specs, instructions, and code snippets), a Tools set exposing 10 ServiceNow SDK commands with full parameter validation, Prompts to streamline common workflows, and Roots support for workspace-aware operations. Extended capabilities include Sampling for automatic AI-driven error analysis when commands fail (MCP 2024-11-05), Elicitation for interactive parameter collection (e.g., init_fluent_app), Session Management that tracks the working directory per session for multi-project workflows, and Root Fallback to MCP root context when no session directory is set. The server emphasizes error handling, type safety through a strict TypeScript implementation, and cross-environment auth with basic and oauth profiles. It also provides quick-start instructions and compatibility with MCP Inspector for testing, making it a comprehensive tool for building, validating, and deploying Fluent apps.

Details

Owner
modesty
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

AI-Powered Error Analysis

Leverages MCP Sampling to diagnose command failures (>50 chars) with root cause, solutions, and prevention tips; configurable via FLUENT_MCP_ENABLE_ERROR_ANALYSIS.

Complete SDK Coverage

Exposes all ServiceNow SDK commands with full parameter validation: auth, init, build, install, dependencies, transform, download, clean, pack.

Rich Resources

Provides API specifications, code snippets, and instructions for 35+ metadata types across 100+ resources.

Multi-Environment Auth

Supports basic and OAuth authentication with profile management.

Session-Aware

Maintains working directory context across commands and supports multi-project workflows.

Elicitation

Interactive parameter collection for complex workflows (e.g., init_fluent_app) with validation and acceptance handling.

Root Fallback

Automatically falls back to MCP root context when no session directory is set.

Type Safety

Full TypeScript implementation with strict typing to ensure reliable, type-safe interactions.

Audience

ServiceNow developersInteract with Fluent SDK commands, API specs, and code snippets within prompts.
AI/ML engineersLeverage MCP features to prompt, validate, and orchestrate SDK tasks.
DevOps / IT teamsManage auth profiles and workflows for Fluent app initialization, building, and deployment.

Tags

fluentservicenowmcpsdkai-assistedcode-snippetsapi-specificationsauthenticationsession-managementerror-analysiselicitation