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许可证。