local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Manages environment configuration for Dynamics 365 connection credentials including client ID, client secret, tenant ID, and service URL.
Provides version control for the codebase, allowing collaborative development through clone, branch, and pull request operations.
Hosts the repository for the MCP server code, enabling collaborative development and issue tracking.

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 （节点包管理器）
具有 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
导航至“设置”>“开发者”>“编辑配置”
编辑 claude_desktop_config.json

{
    "mcpServers": {
        "Dynamics365": {
            "command": "node",
            "args": [
                "<Path to your MCP server build file ex: rootfolder/build/index.js>"
            ],
            "env": {
                "CLIENT_ID": "<D365 Client Id>",
                "CLIENT_SECRET": "<D365 Client Secret>",
                "TENANT_ID": "<D365 Tenant ID>",
                "D365_URL": "Dynamics 365 url"
            }
        }
    }
}

重启Claude桌面
现在您应该能够在提示窗口中看到服务器工具
让我们通过调用工具 get-user-info 来测试提示

调试🐛

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

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

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

贡献🤝

欢迎贡献代码！欢迎提交 Pull 请求或创建 Issue，以解决任何 Bug 或提出任何功能请求。

贡献：

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

模型上下文协议服务器，支持从 MCP 客户端（例如 Claude Desktop）与 Microsoft Dynamics 365/Power Platform 进行交互，允许用户通过自然语言检索、创建和更新数据。

Dynamics 365 MCP Server