Skip to content

Releases: xplusplusai/fo-semantic-mcp

FO Semantic MCP Server v2.1.6

29 Nov 02:58

Choose a tag to compare

FO Semantic MCP Server v2.1.6

AI-powered semantic search for Microsoft Dynamics 365 Finance & Operations development

🎯 What's New

See CHANGELOG.md for detailed release notes.

📦 Installation

Via NPM (Recommended)

npm install fo-semantic-mcp@2.1.6

Or update to latest:

npm update fo-semantic-mcp

Via MCP Registry

Available in the official MCP Registry - search for "fo-semantic-mcp"

🚀 Quick Start

  1. Get your API key at https://www.xplusplus.ai
  2. Configure in Cursor/Claude Desktop:
    {
      "mcpServers": {
        "fo-semantic-mcp": {
          "command": "npx",
          "args": ["-y", "fo-semantic-mcp"],
          "env": {
            "FOINDEX_API_KEY": "your-api-key"
          }
        }
      }
    }
  3. Restart your IDE
  4. Start searching D365 F&O artifacts!

📚 Documentation


Published to:

  • ✅ NPM Registry
  • ✅ MCP Registry
  • ✅ GitHub Releases

Ready to transform your F&O development workflow! 🚀

FO Semantic MCP Server v2.1.5

29 Nov 02:45

Choose a tag to compare

FO Semantic MCP Server v2.1.5

AI-powered semantic search for Microsoft Dynamics 365 Finance & Operations development

🎯 What's New

See CHANGELOG.md for detailed release notes.

📦 Installation

Via NPM (Recommended)

npm install fo-semantic-mcp@2.1.5

Or update to latest:

npm update fo-semantic-mcp

Via MCP Registry

Available in the official MCP Registry - search for "fo-semantic-mcp"

🚀 Quick Start

  1. Get your API key at https://www.xplusplus.ai
  2. Configure in Cursor/Claude Desktop:
    {
      "mcpServers": {
        "fo-semantic-mcp": {
          "command": "npx",
          "args": ["-y", "fo-semantic-mcp"],
          "env": {
            "FOINDEX_API_KEY": "your-api-key"
          }
        }
      }
    }
  3. Restart your IDE
  4. Start searching D365 F&O artifacts!

📚 Documentation


Published to:

  • ✅ NPM Registry
  • ✅ MCP Registry
  • ✅ GitHub Releases

Ready to transform your F&O development workflow! 🚀

FO Semantic MCP Server v2.1.4

29 Nov 02:41

Choose a tag to compare

FO Semantic MCP Server v2.1.4

AI-powered semantic search for Microsoft Dynamics 365 Finance & Operations development

🎯 What's New

See CHANGELOG.md for detailed release notes.

📦 Installation

Via NPM (Recommended)

npm install fo-semantic-mcp@2.1.4

Or update to latest:

npm update fo-semantic-mcp

Via MCP Registry

Available in the official MCP Registry - search for "fo-semantic-mcp"

🚀 Quick Start

  1. Get your API key at https://www.xplusplus.ai
  2. Configure in Cursor/Claude Desktop:
    {
      "mcpServers": {
        "fo-semantic-mcp": {
          "command": "npx",
          "args": ["-y", "fo-semantic-mcp"],
          "env": {
            "FOINDEX_API_KEY": "your-api-key"
          }
        }
      }
    }
  3. Restart your IDE
  4. Start searching D365 F&O artifacts!

📚 Documentation


Published to:

  • ✅ NPM Registry
  • ✅ MCP Registry
  • ✅ GitHub Releases

Ready to transform your F&O development workflow! 🚀

FO Semantic MCP Server v2.1.3

29 Nov 02:25

Choose a tag to compare

FO Semantic MCP Server v2.1.3

AI-powered semantic search for Microsoft Dynamics 365 Finance & Operations development

🎯 What's New

See CHANGELOG.md for detailed release notes.

📦 Installation

Via NPM (Recommended)

npm install fo-semantic-mcp@2.1.3

Or update to latest:

npm update fo-semantic-mcp

Via MCP Registry

Available in the official MCP Registry - search for "fo-semantic-mcp"

🚀 Quick Start

  1. Get your API key at https://www.xplusplus.ai
  2. Configure in Cursor/Claude Desktop:
    {
      "mcpServers": {
        "fo-semantic-mcp": {
          "command": "npx",
          "args": ["-y", "fo-semantic-mcp"],
          "env": {
            "FOINDEX_API_KEY": "your-api-key"
          }
        }
      }
    }
  3. Restart your IDE
  4. Start searching D365 F&O artifacts!

📚 Documentation


Published to:

  • ✅ NPM Registry
  • ✅ MCP Registry
  • ✅ GitHub Releases

Ready to transform your F&O development workflow! 🚀

v2.0.8 - Enhanced README with npm/npx installation options

21 Oct 06:11

Choose a tag to compare

Release v2.0.8 - Enhanced README and Installation Options

What's New

Improved Documentation

  • ? Comprehensive installation section with 3 clear options:
    • Option A: npx (recommended - always latest, zero installation)
    • Option B: Global npm install (for version control and offline use)
    • Option C: Manual GitHub download (for developers and custom setups)
  • ? Added detailed troubleshooting section covering common issues
  • ? Updated "What's New" to reflect v2.0.7+ improvements
  • ? Enhanced configuration examples for Windows, macOS, and Linux
  • ? Clear benefits and use cases for each installation method

User Experience

  • ? Single README that works perfectly for both npm and GitHub
  • ? Better onboarding with step-by-step guidance
  • ? Platform-specific examples (Windows paths vs macOS/Linux paths)
  • ? Troubleshooting help for initialization, timeouts, and file access issues

Installation

Recommended: Use with npx (always latest)

{
  "mcpServers": {
    "fo-semantic-mcp": {
      "command": "npx",
      "args": ["-y", "fo-semantic-mcp"],
      "env": {
        "FOINDEX_API_KEY": "your_api_key_here"
      }
    }
  }
}

Alternative: Global install

npm install -g fo-semantic-mcp

Full Changelog

  • Enhanced README with 3 installation options
  • Added comprehensive troubleshooting section
  • Updated version references to 2.0.8
  • Improved cross-platform documentation
  • Better user guidance for all skill levels

Get your API key: https://www.xplusplus.ai/

?? Generated with Claude Code

v2.0.7 - Add MCP Registry Support

21 Oct 05:36

Choose a tag to compare

MCP Registry Fix

  • Added mcpName field to package.json for MCP registry publication
    • Required by MCP registry: "mcpName": "io.github.xplusplusai/fo-semantic-mcp"
    • Enables discovery in MCP registry

No Functional Changes

This is a metadata-only release. All fixes from v2.0.6 are included:

  • MCP protocol initialization fix (removed stdin encoding)
  • Emoji-free prompts for clean display

Users on v2.0.6 can continue using it - the only difference is MCP registry compatibility.

v2.0.6 - Fix MCP Protocol Initialization

21 Oct 05:29

Choose a tag to compare

Critical Fixes

MCP Protocol Fix

  • Removed process.stdin.setEncoding that was breaking MCP STDIO protocol
    • Was causing 60-second initialization timeouts in Claude Desktop
    • MCP SDK handles its own encoding internally
    • Result: Tools now load correctly in Claude Desktop ?

UX Improvements

  • Removed all emoji characters from Golden Path prompts
    • Fixes corrupted character display in Claude Desktop
    • Cleaner, more readable prompt text

Technical Details

Root Cause: The UTF-8 encoding fix interfered with MCP binary protocol. The MCP SDK expects to handle stdin/stdout encoding itself for proper JSON-RPC framing.

Testing

  • ? Server starts successfully
  • ? MCP initialize handshake completes
  • ? Tools load in Claude Desktop
  • ? Prompts display without corrupted characters

v2.0.0 - Major Architectural Cleanup

14 Oct 19:13

Choose a tag to compare

🎯 Major Architectural Cleanup

This release realigns the codebase to proper MCP architecture principles, removing experimental approaches that didn't work and focusing on what does.

Breaking Changes

  • Server Instructions Simplified - Reduced from 27KB to 1.8KB, now contains concise tool documentation only (not workflow enforcement)
  • Tool Description Updated - Removed command injection attempts, now provides factual artifact search description
  • Tool Responses Cleaned - Removed workflow checklists from search results, returns clean data only
  • Single Prompt - Consolidated two confusing prompts into one clear fo-development-assistant prompt
  • Removed Obfuscation - Standard TypeScript build for transparency and easier maintenance

Added

  • MCP Prompt fo-development-assistant - Complete 6-step F&O development workflow (works in Claude Desktop)
  • Honest Documentation - Clear about what works automatically vs what requires manual guidance
  • Production Package - Only essential runtime files included in releases

Improved

  • MCP Compliance - Proper separation of concerns: server instructions (tool docs), prompts (workflows), tool responses (data)
  • Simpler Build - No obfuscation, standard TypeScript compilation
  • Clean Releases - No development artifacts, intermediate files, or build scripts in production packages
  • Better UX - One prompt with clear purpose instead of multiple overlapping prompts

Removed

  • Golden Path Auto-Workflow - Research proved AI clients filter commands in tool responses by design (security)
  • Obfuscation - No proprietary IP to protect, educational content benefits from transparency
  • Duplicate Prompts - Removed confusing fo-coding-task alias
  • Build Artifacts - Removed dist-obfuscated folder and obfuscation scripts

Fixed

  • 🐛 Architectural Misalignment - Server instructions now serve their intended purpose (brief tool guidance, not workflows)
  • 🐛 False Marketing - README no longer claims automatic workflow enforcement in Cursor (it doesn't work)
  • 🐛 Bloated Instructions - Embedded instructions reduced by 93% (27KB → 1.8KB)

Migration from v1.x

No breaking API changes for end users. Simply:

  1. Update your installation
  2. Restart your AI client (Cursor/Claude Desktop)
  3. In Claude Desktop, try the new fo-development-assistant prompt

Installation

# Download and extract the release
# Then install dependencies
npm install

# Configure your MCP client with:
# - FOINDEX_API_KEY (required)
# - FO_LOCAL_ASSETS_PATH (recommended)

See README.md and GETTING_STARTED.md for full installation instructions.

Technical Details

Why These Changes:

  • MCP security design prevents tool response command injection (defense against tool poisoning attacks)
  • Cursor IDE doesn't support MCP prompts (platform limitation)
  • Server instructions are background context, not behavioral enforcement mechanisms
  • Prompts are the correct MCP construct for workflows (user-invoked, works in Claude Desktop)

What Still Works:

  • ✅ Semantic search over 50,000+ F&O artifacts
  • ✅ Local file access via FO_LOCAL_ASSETS_PATH
  • ✅ Rich metadata (descriptions, business domains, modules)
  • ✅ All existing tool parameters and responses

What Changed:

  • ✅ Tool responses now return clean data (no checklists)
  • ✅ Server instructions are concise (proper scope)
  • ✅ Workflows moved to prompts (proper architecture)

v1.3.5 - Golden Path Instructions Update + Project Restructure

12 Oct 17:00

Choose a tag to compare

Release v1.3.5 - Golden Path Instructions Update + Project Restructure

🎯 Golden Path Instructions Enhanced

AI Development Workflow Improvements:

  • ✅ Complete 6-step Golden Path methodology verified and updated
  • ✅ Enhanced automatic workspace code search instructions
  • ✅ Improved context-aware F&O development guidance
  • ✅ Updated embeddedInstructions.js with latest content (118KB obfuscated)

📦 Project Structure Improvements

Release Cleanup:

  • ✅ CHANGELOG.md now kept private in development folder only
  • ✅ Clean public releases without internal version history
  • ✅ Updated .gitignore to exclude development documentation

📝 What Changed

Files Updated:

  • dist/embeddedInstructions.js - Latest Golden Path instructions
  • .gitignore - Exclude CHANGELOG.md from releases
  • package.json - Version 1.3.5
  • Removed CHANGELOG.md from public distribution

🔧 Technical Details

Obfuscation Strategy:

  • Minimalist approach: Only embeddedInstructions.js obfuscated
  • MCP SDK completely untouched for protocol compliance
  • Zero bundling - clean file structure
  • 29KB instructions → 118KB obfuscated

📥 Installation

No changes to installation process. Use as before:

{
  "mcpServers": {
    "fo-semantic-mcp": {
      "command": "node",
      "args": ["path/to/fo-semantic-mcp-release/dist/server.js"],
      "env": {
        "FOINDEX_API_KEY": "your-api-key",
        "FO_LOCAL_ASSETS_PATH": "C:\path\to\PackagesLocalDirectory"
      }
    }
  }
}

Full Changelog: See development repository for complete version history

FO Semantic MCP v1.3.4 - Minimalist Obfuscation (WORKS!)

09 Oct 17:28

Choose a tag to compare

✅ Minimalist Obfuscation - Surgical IP Protection

What's Fixed

The Winning Strategy: Stop trying to obfuscate everything. Protect ONLY what matters.

v1.3.2/v1.3.3 Problem: Bundling/obfuscating entire codebase broke MCP JSON-RPC protocol

v1.3.4 Solution: Surgical approach - obfuscate ONLY embeddedInstructions.js

Changes

Tool Registration WORKS - Zero bundling = zero protocol issues
Obfuscate IP Only - Instructions file: 29KB → 115KB (obfuscated)
MCP Protocol Clean - All protocol code untouched and readable
Standard Structure - Normal dist/ folder, only instructions protected
100% Compatible - Works with all MCP clients (Cursor IDE, Claude Desktop, VS Code)

Technical Details

Minimalist Build Process:

  1. Embed instructions from markdown → TypeScript
  2. Build TypeScript → JavaScript (normal)
  3. Copy entire dist/ to dist-obfuscated/
  4. Obfuscate ONLY embeddedInstructions.js in place

What's Obfuscated:

  • dist/embeddedInstructions.js (115KB obfuscated)

What's NOT Obfuscated:

  • dist/server.js (clean, readable)
  • dist/tools/ (clean, readable)
  • dist/services/ (clean, readable)
  • dist/utils/ (clean, readable)
  • node_modules/@modelcontextprotocol/sdk (untouched)

Result:

  • MCP protocol: 100% compliant (no modifications)
  • Your IP: 100% protected (instruction content obfuscated)
  • File size: Minimal (only 115KB obfuscated file)
  • Debuggable: All code except instructions readable

Why This Approach Wins

Lesson Learned: Don't obfuscate protocol implementations!

  • Protocol libraries stay clean (MCP SDK untouched)
  • Protocol implementation stays clean (server.js readable)
  • Only IP gets protected (instructions obfuscated)
  • Zero compatibility issues (standard JavaScript structure)

Installation

  1. Download the latest release (Source code zip/tar.gz)
  2. Extract to your preferred location
  3. Get API Key from https://www.xplusplus.ai/
  4. Configure your MCP client:
{
  "mcpServers": {
    "fo-semantic-mcp": {
      "command": "node",
      "args": ["path/to/fo-semantic-mcp/dist/server.js"],
      "env": {
        "FOINDEX_API_KEY": "your_api_key"
      }
    }
  }
}
  1. Restart your MCP client
  2. Verify tool appears: search_fo_artifacts

See README.md for detailed setup.


Full Changelog: https://github.com/xplusplusai/fo-semantic-mcp/blob/main/CHANGELOG.md#134---2025-10-09