mcp-business-central

This MCP server exposes a set of tools to interact with Microsoft Dynamics 365 Business Central entities via the Model Context Protocol (MCP). The available tools include BC_Get_Schema to retrieve the schema for a given Business Central entity, BC_List_Items to fetch lists of entities with optional filtering and pagination, BC_Get_Items_By_Field to search entities by a specific field value, BC_Create_Item to create new records, BC_Update_Item to modify existing records, and BC_Delete_Item to remove records. To use the server, configure the mcpServers section with your BC credentials and point clients to the server’s address. The server expects you to specify the target BC entity (table) and the appropriate fields when invoking these tools. Ensure your BC_URL_SERVER, BC_USER, BC_PASS, and BC_COMPANY environment variables are set correctly before starting the server.

Prerequisites:

• Python 3.10+
• Git installed
• Access to the Business Central API (with proper credentials)

Installation steps:

1. Clone the repository: git clone https://github.com/xxx/mcp-business-central-server.git
2. Navigate to the project directory: cd mcp-business-central-server
3. Create and activate a virtual environment: python -m venv .venv source .venv/bin/activate # On Windows: ..venv\Scripts\activate
4. Install development dependencies (editable mode): pip install -e .
5. Install from PyPI (alternative for production): pip install mcp-business-central-server
6. Prepare environment variables (BC_URL_SERVER, BC_USER, BC_PASS, BC_COMPANY) in a .env file or your environment before running the server.
7. Run the server: python -m mcp_bc_server

Optional (using uv for development):

• Install uv and run tests or server as described in the docs: uv pip install mcp-business-central-server

Environment variables are critical for authenticating with Business Central. Keep BC_PASS secure and consider using a secrets manager in production. The server relies on the exact Business Central entity names (tables) as exposed by the BC API; entity names are case-sensitive. If you encounter rate-limiting or authentication issues, verify that BC_URL_SERVER points to the correct tenant URL and that BC_COMPANY is the active company. When integrating with clients like Claude Desktop, provide the same environment variables in the integration configuration. For local development, a .env file with the BC credentials is a convenient approach, but ensure it is not committed to version control.