1.3.1

MCP Nexus v1.3.1 Release Notes

🚀 Major New Features

🤝 MCP Client Integrations & Stdio Mode

• Added first-class integration workflows for Cursor IDE and Google Antigravity, with ready-to-use MCP configuration snippets for both stdio and HTTP modes.
• Introduced visual integration demos (animation assets under images/integrations/) that walk through connecting MCP Nexus from popular AI clients.
• The startup banner now clearly reports the active transport mode (stdio vs HTTP) along with host, port, environment, and key configuration values, making it much easier to verify how the server is running at a glance.

⚡ Reliability & MCP Stdio Hardening

🔇 Clean JSON-RPC Channel for Stdio

• Reworked the logging pipeline for stdio mode so that:
  • All framework and application logging is routed through NLog and written to files, never to stdout.
  • Default console/debug providers are removed via ClearProviders(), preventing accidental writes to the stdio channel.
  • Additional logging filters suppress noisy categories (e.g., ModelContextProtocol.Server.StdioServerTransport, ModelContextProtocol.Server.McpServer, Microsoft.Hosting.Lifetime) that could interfere with MCP traffic.
• These changes ensure that when running in MCP stdio transport mode, stdout is reserved exclusively for JSON-RPC messages, significantly improving compatibility with strict MCP clients and tooling.

🛰️ HTTP/STDIO Mode Detection & Reporting

• Enhanced mode detection to distinguish between HTTP server, stdio server, Windows service, and install/update/uninstall commands, and to surface this clearly in the startup output.
• Host and port resolution now prefers configuration, falling back cleanly to ASPNETCORE_URLS and sensible defaults, reducing configuration surprises when switching between HTTP and stdio workflows.

🧪 Quality & Testing

• Strengthened configuration and logging tests to cover the updated logging pipeline, including interaction with the ILoggingBuilder and service collection.
• Ensured tests remain fully isolated and deterministic, validating that the stdio-safe logging behavior does not regress.
• Maintained overall test pass status and kept line and branch coverage well above the 75% thresholds.

🐛 Fixes & UX Polish

• Fixed a compatibility issue in stdio transport usage that could cause incorrect behavior or noisy output when used with MCP clients (notably Google Antigravity).
• Refined the startup banner layout and content, giving operators a more readable snapshot of:
  • Transport mode and environment
  • Server, debugging, validation, service, and logging configuration
  • Key environment variables and system information
• Updated the README with:
  • Clear integration guides for Cursor and Google Antigravity
  • Modernized examples and configuration snippets
  • Refreshed badges and test/coverage statistics to reflect the current state of the project.