MCP Dynamics365 Server

🚀 動態365 MCP服務器

動態365 MCP服務器 是一個基於Anthorpic的 Model Context Protocol(MCP) 實現的MCP服務器。它允許用戶通過MCP協議與Microsoft Dynamics 365交互，提供諸如檢索用戶信息、賬戶、與指定賬戶關聯的機會，以及從 Claude Desktop 創建和更新賬戶等功能。

🚀 快速開始

先決條件 🛠️

在開始之前，請確保以下幾點：

• 安裝了最新版本的Node.js（推薦使用v16及以上）。
• 安裝了Yarn或NPM（用於包管理）。
• 配置了一個有效的Dynamics 365實例，並具有必要的API訪問權限。

配置步驟

1. 克隆倉庫

使用以下命令克隆此倉庫到本地：

git clone [your-repository-url]
cd dynamics-365-mcp-server

2. 安裝依賴

運行以下命令安裝所需的依賴項：

• 如果您使用Yarn：

yarn install

• 如果您使用NPM：

npm install

3. 配置環境變量

在項目根目錄創建一個.env文件，並填寫以下內容，確保所有字段與您的Dynamics 365實例匹配：

DYNAMICS_365_URL=https://your-dynamics-365-endpoint
CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret
TENANT_ID=your-tenant-id

4. 編譯TypeScript文件（可選）

如果您希望生成JavaScript文件，運行以下命令：

yarn build

或者

npm run build

5. 運行服務器

使用以下命令啟動服務器：

yarn start

或

npm start

默認情況下，服務器將在http://localhost:3000上運行。

✨ 主要特性

該項目使用@modelcontextprotocol/sdk庫來實現MCP服務器和工具，並集成Dynamics 365 API以進行數據操作。它提供了一系列工具，允許用戶與Microsoft Dynamics 365進行交互，具體如下：

💡 可選步驟：Claude Desktop集成

要將此服務器與Claude Desktop集成，請按照以下步驟操作：

1. 安裝Claude CLI

在終端中運行：

pip install claude-cli

2. 註冊服務器

在Claude Desktop中，導航到“連接”菜單，並添加新的MCP服務器。配置所需的端點和其他參數。

🐛 調試

如果遇到問題，請檢查以下事項：

• 確保.env文件已正確配置。
• 確保Azure AD應用程序具有訪問Dynamics 365 API的必要權限。
• 確保您的環境可以訪問Dynamics 365實例。

您還可以在代碼中添加調試日誌以跟蹤問題。例如：

console.error("調試：加載的環境變量:", process.env);

🤝 貢獻

歡迎貢獻！請隨意提交pull request或打開問題報告任何錯誤或功能請求。 要進行貢獻：

• Fork此倉庫。
• 為您的功能或修復創建一個新的分支。
• 提交更改並提交一個pull request。
• 我們感謝您的貢獻！ 😊

📄 許可證

本項目採用MIT許可證。