MCP Business Central Server

🚀 商業中央 MCP 服務器

一個輕量級的 MCP 服務器，用於與微軟 Dynamics 365 Business Central 進行無摩擦集成。藉助它，MCP 客戶能夠與商業中央環境中的任何實體進行交互。本項目由 sofias tech 開發。

🚀 快速開始

安裝

# 使用 pip 安裝
pip install mcp-business-central-server

# 或者使用 Git 克隆倉庫
git clone https://github.com/xxx/mcp-business-central-server.git
cd mcp-business-central-server
python setup.py install

使用 uv

uvicorn business_central.mcp_server:app --reload

✨ 主要特性

此服務器通過 Model Context Protocol (MCP) 提供對商業中央資源的簡潔接口，並通過優化 HTTP 請求處理提高性能。

工具

該服務器實現了以下工具：

• BC_Get_Schema：檢索任何商業中央實體的架構，包括可用字段
• BC_List_Items：獲取實體列表，支持可選過濾和分頁
• BC_Get_Items_By_Field：根據特定字段值搜索實體
• BC_Create_Item：在商業中央創建新的實體記錄
• BC_Update_Item：更新現有實體記錄
• BC_Delete_Item：從商業中央刪除實體記錄

📦 安裝指南

創建憑證與配置信息

1. 創建商業中央 API 憑證。
2. 配置您的商業中央環境和公司信息。

設置環境變量

服務器需要以下環境變量：

• BC_URL_SERVER：您的商業中央 API 服務器 URL（例如，“https://api.businesscentral.dynamics.com/v2.0/tenant/api/v2.0”）
• BC_USER：您的商業中央 API 用戶名
• BC_PASS：您的商業中央 API 密碼
• BC_COMPANY：您的商業中央公司名稱

📚 詳細文檔

與商業中央實體一起使用

此服務器可以處理商業中央中的任何實體。使用工具時，您必須提供與商業中央 API 顯示相同的實體名稱。例如：

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

實體名稱區分大小寫，並且必須與商業中央暴露的名稱完全匹配。

與 Claude Desktop 集成

標準集成

在您的 config.json 文件中添加以下內容：

{
  "business_central": {
    "host": "http://localhost:8000",
    "api_key": "your_api_key_here"
  }
}

使用 uvx

在您的 config.json 文件中添加以下內容：

{
  "uv": {
    "host": "http://localhost:8000",
    "token": "your_token_here"
  }
}

開發

要求

• Python 3.8 或更高版本
• requests 庫
• uvicorn（可選，用於調試）

本地開發

1. 克隆倉庫：

git clone https://github.com/xxx/mcp-business-central-server.git
cd mcp-business-central-server

2. 安裝依賴項：

pip install -r requirements.txt

3. 啟動服務器（可選調試模式）：

uvicorn business_central.mcp_server:app --reload

調試

使用以下命令查看日誌和錯誤信息：

python -m business_central.mcp_server

🔧 技術細節

該服務器以資源效率為設計理念：

• 資源管理與工具實現之間的清晰分離
• 簡單且易於維護的代碼庫，減少重複代碼
• 直接使用 requests 庫進行 HTTP 請求處理

📄 許可證

MIT License

Copyright (c) 2025 sofias tech