Releases: xplusplusai/fo-semantic-mcp
FO Semantic MCP Server v2.1.6
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.6Or update to latest:
npm update fo-semantic-mcpVia MCP Registry
Available in the official MCP Registry - search for "fo-semantic-mcp"
🚀 Quick Start
- Get your API key at https://www.xplusplus.ai
- Configure in Cursor/Claude Desktop:
{ "mcpServers": { "fo-semantic-mcp": { "command": "npx", "args": ["-y", "fo-semantic-mcp"], "env": { "FOINDEX_API_KEY": "your-api-key" } } } } - Restart your IDE
- 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
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.5Or update to latest:
npm update fo-semantic-mcpVia MCP Registry
Available in the official MCP Registry - search for "fo-semantic-mcp"
🚀 Quick Start
- Get your API key at https://www.xplusplus.ai
- Configure in Cursor/Claude Desktop:
{ "mcpServers": { "fo-semantic-mcp": { "command": "npx", "args": ["-y", "fo-semantic-mcp"], "env": { "FOINDEX_API_KEY": "your-api-key" } } } } - Restart your IDE
- 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
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.4Or update to latest:
npm update fo-semantic-mcpVia MCP Registry
Available in the official MCP Registry - search for "fo-semantic-mcp"
🚀 Quick Start
- Get your API key at https://www.xplusplus.ai
- Configure in Cursor/Claude Desktop:
{ "mcpServers": { "fo-semantic-mcp": { "command": "npx", "args": ["-y", "fo-semantic-mcp"], "env": { "FOINDEX_API_KEY": "your-api-key" } } } } - Restart your IDE
- 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
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.3Or update to latest:
npm update fo-semantic-mcpVia MCP Registry
Available in the official MCP Registry - search for "fo-semantic-mcp"
🚀 Quick Start
- Get your API key at https://www.xplusplus.ai
- Configure in Cursor/Claude Desktop:
{ "mcpServers": { "fo-semantic-mcp": { "command": "npx", "args": ["-y", "fo-semantic-mcp"], "env": { "FOINDEX_API_KEY": "your-api-key" } } } } - Restart your IDE
- 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
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-mcpFull 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
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
- Required by 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
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
🎯 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-assistantprompt - 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-taskalias - ❌ 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:
- Update your installation
- Restart your AI client (Cursor/Claude Desktop)
- In Claude Desktop, try the new
fo-development-assistantprompt
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
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 releasespackage.json- Version 1.3.5- Removed
CHANGELOG.mdfrom 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!)
✅ 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:
- Embed instructions from markdown → TypeScript
- Build TypeScript → JavaScript (normal)
- Copy entire dist/ to dist-obfuscated/
- Obfuscate ONLY
embeddedInstructions.jsin 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
- Download the latest release (Source code zip/tar.gz)
- Extract to your preferred location
- Get API Key from https://www.xplusplus.ai/
- 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"
}
}
}
}- Restart your MCP client
- 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