金大哥 - mcp-dyamics365-server MCP 详情

article

README

🚀 微软 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);

🤝 贡献

欢迎贡献！请随意提交拉取请求或为任何错误或功能请求打开问题。要进行贡献：

叉克隆仓库。
为你的功能或修复创建新分支。
提交更改并提出拉取请求。
我们感谢你的贡献！ 😊

mcp-dyamics365-server