Dynamics 365 MCP 服务器 🚀

概述

Microsoft Dynamics 365 MCP 服务器 是一个 MCP 服务器，它提供使用 Anthorpic 的 模型上下文协议 (MCP) 与 Microsoft Dynamics 365 交互的工具。它允许用户执行各种操作，例如检索用户信息、帐户、与帐户关联的商机，以及从 Claude Desktop 创建和更新帐户。

本项目使用 @modelcontextprotocol/sdk 库来实现 MCP 服务器和工具，并与 Dynamics 365 API 集成以进行数据操作。

---

工具列表 🛠️

工具名称	描述	输入	输出
get-user-info	获取当前已验证用户的信息。	无	用户详细信息，包括姓名、用户 ID 和业务部门 ID。
fetch-accounts	从 Dynamics 365 获取所有帐户。	无	JSON 格式的帐户列表。
get-associated-opportunities	获取与给定帐户关联的商机。	accountId（字符串，必需）	JSON 格式的商机列表。
create-account	在 Dynamics 365 中创建一个新帐户。	accountData（对象，必需），包含帐户详细信息。	JSON 格式的已创建帐户的详细信息。
update-account	更新 Dynamics 365 中的现有帐户。	accountId（字符串，必需），accountData（对象，必需），包含更新后的详细信息。	JSON 格式的已更新帐户的详细信息。

---

前提条件 📝

在设置项目之前，请确保已安装以下各项：

• Node.js (v16 或更高版本)
• NPM (Node 包管理器)
• 具有 API 访问权限的 Dynamics 365 实例
• 为 Dynamics 365 API 访问配置的 Azure Active Directory (AAD) 应用程序

---

配置步骤 ⚙️

按照以下步骤设置并在本地运行项目：

1. 克隆存储库

git clone https://github.com/your-repo/dynamics365-mcp-server.git
cd dynamics365-mcp-server

2. 安装依赖项

npm install

3. 配置环境变量

在项目根目录中创建一个 .env 文件，并添加以下变量：

CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret
TENANT_ID=your-tenant-id
D365_URL=https://your-org.crm.dynamics.com

4. 编译 TypeScript 文件

npm run build

4. 运行 MCP 服务器

node build\index.js

您应该看到以下输出：

Dynamics365 MCP server running on stdio...

5. (可选) 在 Claude Desktop 中注册您的 MCP 服务器

• 安装 Claude Desktop
• 导航到 Settings > Developer > Edit Config
• 编辑 claude_desktop_config.json

{
    "mcpServers": {
        "Dynamics365": {
            "command": "node",
            "args": [
                "<MCP 服务器构建文件的路径，例如：rootfolder/build/index.js>"
            ],
            "env": {
                "CLIENT_ID": "<D365 客户端 ID>",
                "CLIENT_SECRET": "<D365 客户端密钥>",
                "TENANT_ID": "<D365 租户 ID>",
                "D365_URL": "Dynamics 365 url"
            }
        }
    }
}

• 重启 Claude Desktop

• 现在您应该能够在提示窗口中看到服务器工具

• 让我们通过调用工具 - get-user-info 来测试一个提示

调试 🐛

如果您遇到问题，请确保以下各项：

如果您遇到问题，请确保以下各项：

• .env 文件已正确配置。
• Azure AD 应用程序具有 Dynamics 365 API 所需的权限。
• 可以从您的环境访问 Dynamics 365 实例。
• 您还可以在代码中添加调试日志以跟踪问题。例如：

console.error("Debugging: Loaded environment variables:", process.env);

贡献 🤝

欢迎贡献！请随时提交拉取请求或针对任何错误或功能请求打开一个 issue。

要贡献：

• Fork 存储库。
• 为您的功能或错误修复创建一个新分支。
• 提交您的更改并提交拉取请求。
• 我们感谢您的贡献！ 😊