Business Central MCP 服务器

一个轻量级的 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. 创建一个包含您的 Business Central 凭据的 .env 文件：

   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 文件。

版权所有 (c) 2025 sofias tech