Business Central MCP Server

这是一个轻量级的MCP服务器，用于与Microsoft Dynamics 365 Business Central无缝集成，使MCP客户端能够与Business Central环境中的任何实体进行交互。该服务器由sofias tech开发。

功能

此服务器通过模型上下文协议（MCP）提供了一个干净的接口来访问Business Central资源，并优化了HTTP请求处理以提高性能。

工具

该服务器实现了以下工具：

• BC_Get_Schema：检索任何Business Central实体的模式，包括可用字段
• BC_List_Items：获取实体列表，可选过滤和分页
• BC_Get_Items_By_Field：根据特定字段值搜索实体
• BC_Create_Item：在Business Central中创建新的实体记录
• BC_Update_Item：更新现有的实体记录
• BC_Delete_Item：从Business Central中删除实体记录

使用Business Central实体

此服务器可以与Business Central中的任何实体（表）进行交互。使用这些工具时，必须提供与Business Central中显示完全一致的实体名称。例如：

• Employees
• Customers
• Items
• Vendors
• SalesOrders
• Payments

实体名称是区分大小写的，必须与Business Central通过其API暴露的名称完全匹配。

架构

该服务器的设计考虑到了资源效率：

• 资源管理和工具实现之间的清晰分离
• 简单且易于维护的代码库，最小化代码重复
• 使用requests库直接处理HTTP请求

配置

1. 为Business Central创建API凭证
2. 配置您的Business Central环境和公司信息
3. 设置所需的环境变量

环境变量

服务器需要以下环境变量：

• BC_URL_SERVER：您的Business Central API服务器URL（例如："https://api.businesscentral.dynamics.com/v2.0/tenant/api/v2.0"）
• BC_USER：您的Business Central API用户名
• BC_PASS：您的Business Central API密码
• BC_COMPANY：您的Business Central公司的名称

快速开始

安装

pip install -e .

或者发布到PyPI后安装：

pip install mcp-business-central-server

使用uv：

uv pip install mcp-business-central-server

Claude Desktop集成

要与Claude Desktop集成，请更新配置文件：

在Windows上：%APPDATA%/Claude/claude_desktop_config.json 在macOS上：~/Library/Application\ Support/Claude/claude_desktop_config.json

标准集成

"mcpServers": {
  "businesscentral": {
    "command": "mcp-business-central-server",
    "env": {
      "BC_URL_SERVER": "your-bc-api-url",
      "BC_USER": "your-bc-username",
      "BC_PASS": "your-bc-password",
      "BC_COMPANY": "your-bc-company"
    }
  }
}

使用uvx

"mcpServers": {
  "businesscentral": {
    "command": "uvx",
    "args": [
      "mcp-business-central-server"
    ],
    "env": {
      "BC_URL_SERVER": "your-bc-api-url",
      "BC_USER": "your-bc-username",
      "BC_PASS": "your-bc-password",
      "BC_COMPANY": "your-bc-company"
    }
  }
}

开发

要求

• Python 3.10+
• 在requirements.txt和pyproject.toml中列出的依赖项

本地开发

1. 克隆仓库
2. 创建虚拟环境：

   python -m venv .venv
   source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
   

3. 安装开发依赖项：

   pip install -e .
   

4. 创建一个.env文件并添加您的Business Central凭证：

   BC_URL_SERVER=your-bc-api-url
   BC_USER=your-bc-username
   BC_PASS=your-bc-password
   BC_COMPANY=your-bc-company
   

5. 运行服务器：

   python -m mcp_bc_server
   

调试

要调试MCP服务器，您可以使用MCP Inspector：

npx @modelcontextprotocol/inspector -- python -m mcp_bc_server

许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

版权所有 © 2025 sofias tech