fo-semantic

FO Semantic MCP Server provides semantic search capabilities over Microsoft Dynamics 365 Finance & Operations artifacts and allows reading local F&O XML files when configured. The primary MCP tool exposed by this server is search_FO_artifacts, which returns artifact metadata such as name, type, module, AI-generated descriptions, usage context, business domain, and local file paths if you enable access to local assets. If you have the optional FO_LOCAL_ASSETS_PATH configured, you can rely on the server to read actual F&O XML sources for deeper analysis. Additionally, for Claude Desktop users, there is a specialized prompt workflow called fo-development-assistant that guides a 6-step process: search standard artifacts, read standard implementations, search your workspace for custom code, read your customizations, generate context-aware solutions, and present a comprehensive analysis. In Cursor IDE and VS Code, you can manually guide the AI through similar steps or use the available workflows with the npx-based installation to keep the server up to date.

Prerequisites:

• Node.js (version 18+ recommended)
• npm (comes with Node.js)
• Access to your API key from xplusplus.ai

Install and run using NPX (recommended):

1. Ensure you have Node.js installed
2. Start the MCP server with NPX so you always run the latest version:

# Example for Cursor IDE / Claude Desktop / VS Code clients
npx -y fo-semantic-mcp

Configure environment variables (example):

{
  "mcpServers": {
    "fo-semantic-mcp": {
      "command": "npx",
      "args": ["-y", "fo-semantic-mcp"],
      "env": {
        "FOINDEX_API_KEY": "your_api_key_here",
        "FO_LOCAL_ASSETS_PATH": "C:\\Users\\YourName\\AppData\\Local\\Microsoft\\Dynamics365\\10.0.xxxx\\PackagesLocalDirectory"
      }
    }
  }
}

If you prefer a global installation:

npm install -g fo-semantic-mcp

Then configure with:

{
  "mcpServers": {
    "fo-semantic-mcp": {
      "command": "fo-semantic-mcp",
      "env": {
        "FOINDEX_API_KEY": "your_api_key_here",
        "FO_LOCAL_ASSETS_PATH": "C:\\Users\\YourName\\AppData\\Local\\Microsoft\\Dynamics365\\10.0.xxxx\\PackagesLocalDirectory"
      }
    }
  }
}

To install from a local GitHub release folder (manual installation):

# 1) Download latest release and extract
# 2) Run npm install inside the extracted folder

Then run using the full path as in the manual setup example within your MCP client configuration.

Environment variables: FOINDEX_API_KEY is required. FO_LOCAL_ASSETS_PATH enables reading local F&O XML files and is optional but recommended for full analysis. If FO_LOCAL_ASSETS_PATH is not configured, the server will still perform semantic searches but cannot access local XML sources. For macOS/Linux, use forward slashes in paths. Keep your API key secure and rotate it as recommended by the provider. The server is designed to work across Windows, macOS, and Linux when using Node.js. If you encounter connectivity issues, ensure your firewall allows the MCP client to reach the API endpoint and that the API key is valid for your plan.