MCP Business Central Server

🚀 ビジネスセントラル MCP サーバー

このサーバーは、軽量な MCP サーバーで、Microsoft Dynamics 365 Business Central との摩擦のない統合を実現し、MCP の顧客がビジネスセントラル環境内の任意のエンティティとやり取りできるようにします。sofias techによって開発されています。

🚀 クイックスタート

このビジネスセントラル MCP サーバーを使用することで、Microsoft Dynamics 365 Business Central とのシームレスな統合が可能になります。以下に、基本的なセットアップと使用方法を説明します。

インストール

# 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. ビジネスセントラルの環境と会社情報を設定します。
3. 必要な環境変数を設定します。

環境変数

サーバーは以下の環境変数を必要とします。

📚 ドキュメント

ビジネスセントラルエンティティとの連携

このサーバーは、ビジネスセントラル内の任意のエンティティを処理できます。ツールを使用する際には、ビジネスセントラル API で表示されるのと同じエンティティ名を指定する必要があります。例えば：

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

エンティティ名は大文字と小文字が区別され、ビジネスセントラルで公開されている名前と完全に一致する必要があります。

アーキテクチャ

このサーバーは、リソース効率を重視して設計されています。

• リソース管理とツール実装の明確な分離。
• シンプルで保守が容易なコードベースで、重複するコードを削減。
• requests ライブラリを直接使用した HTTP リクエストの処理。

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

📄 ライセンス

MIT License

Copyright (c) 2025 sofias tech