🚀 微软 Dynamics 365 MCP 服务器
微软 Dynamics 365 MCP 服务器 是一个基于 Model Context Protocol (MCP) 的服务器，用于与 Microsoft Dynamics 365 进行交互。它提供了多种实用工具，能帮助用户获取用户信息、检索账户、关联的商机，还能从 Claude Desktop 创建和更新账户，为用户与 Dynamics 365 的交互提供了便利。
✨ 主要特性
- 基于 Model Context Protocol (MCP)，可与 Microsoft Dynamics 365 进行交互。
- 提供多种工具，支持获取用户信息、检索账户、关联商机以及创建和更新账户等操作。
- 使用
@modelcontextprotocol/sdk库实现 MCP 服务器和工具，并集成 Dynamics 365 API 进行数据操作。
📦 安装指南
先决条件 📝
在设置项目之前，请确保以下内容已安装：
- Node.js：版本 v16 或更高。
- NPM（Node 包管理器）。
- 微软 Dynamics 365 实例及其 API 的访问权限。
配置步骤 🛠️
步骤 1：克隆仓库
在终端中运行以下命令以克隆项目仓库：
git clone [你的仓库地址]
cd dynamics-365-mcp-server
步骤 2：安装依赖项
运行以下命令以安装项目所需的依赖项：
npm install
步骤 3：配置环境变量
创建一个 .env 文件，并添加以下内容，确保替换占位符为你的实际值：
PORT=3000
AZURE_CLIENT_ID=[你的应用程序客户 ID]
AZURE_CLIENT_SECRET=[你的应用程序密码]
DYNAMICS_365_URL=[你的 Dynamics 365 实例 URL]
步骤 4：启动服务器
运行以下命令以启动 MCP 服务器：
npm start
服务器将在指定的端口（默认为 3000）上运行。
💻 使用示例
工具列表 🛠️
| 工具名称 | 描述 | 输入 | 输出 |
|---|---|---|---|
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 格式返回。 |
🔧 技术细节
该项目使用 @modelcontextprotocol/sdk 库来实现 MCP 服务器和工具，并通过 Dynamics 365 API 进行数据操作集成。
📄 许可证
本项目采用 MIT 许可证。
🐛 调试
如果遇到问题，请确保以下内容：
.env文件已正确配置。- Azure AD 应用程序具有访问 Dynamics 365 API 的必要权限。
- Dynamics 365 实例可以从你的环境中访问。
- 如果需要，可以在代码中添加调试日志以跟踪问题。例如：
console.error("调试：加载的环境变量为：", process.env);
🤝 贡献
欢迎贡献！请随意提交拉取请求或为任何错误或功能请求打开问题。 要进行贡献：
- 叉克隆仓库。
- 为你的功能或修复创建新分支。
- 提交更改并提出拉取请求。
- 我们感谢你的贡献！ 😊