金大哥 - solyn_dynamics365_mcp

article

README

🚀 Solyn Dynamics 365 MCP 服务器项目

Solyn Dynamics 365 MCP（模型上下文协议）服务器是一款用于与微软 Dynamics 365 实例集成的工具。它支持通过通用实体查询方法和多种 CRM 操作（如创建、读取、更新和删除）与系统交互。该服务器专为 Claude Desktop 设计，用户可通过配置在桌面环境中直接调用 Dynamics 365 的功能。

🚀 快速开始

图标表示

✨ 主要特性

支持与微软 Dynamics 365 实例集成。
支持通过通用实体查询方法和多种 CRM 操作与系统交互。
专为 Claude Desktop 设计，可在桌面环境中直接调用 Dynamics 365 功能。

📦 安装指南

先决条件

在设置项目之前，请确保以下事项已准备就绪：

Python 版本：3.10 或更高版本。
对 Dynamics 365 实例的 API 访问权限。
在 Azure Active Directory (AAD) 中配置的应用程序，并具有以下权限：
- Dynamics CRM 用户代入权限（user_impersonation）。
- Office 365 Exchange Online 权限。

安装步骤

1. 克隆代码库

git clone https://github.com/your-repo/Dynamic_CRM_MCP_Server.git
cd Dynamic_CRM_MCP_Server

2. 安装依赖项

pip install -r requirements.txt

📚 详细文档

工具列表

以下是与 Dynamics 365 集成的可用工具及其详细信息：

| 属性 | 详情 | |------|------| | 图标 | 图标路径 | | 实体名称 | 用于标识 CRM 实体（如“Account”或“Contact”）。 | | 描述 | 工具的功能描述。 | | 输入参数 | 包括过滤器、选择项和扩展等可选参数，支持 OData 格式。 | | 输出结果 | 查询返回的结果集，以 JSON 格式呈现。 |

Claude Desktop 集成

在您的 Claude 设置文件（settings.json）中添加以下配置：

{
    "mcpServers": {
        "Dynamic_CRM_MCP_Server": {
            "command": "python",
            "args": ["Dynamic_CRM_MCP_Server/server.py"],
            "env": {
                "CLIENT_ID": "<your_client_id>",         # Azure AD 应用程序 ID
                "CLIENT_SECRET": "<your_client_secret>",  # Azure AD 客户端密码
                "TENANT_ID": "<your_tenant_id>",         # Azure 目录（租户）ID
                "RESOURCE": "<your_dynamics365_resource_url>"  # Dynamics 365 实例 URL，例如 https://orgname.crm.dynamics.com
            }
        }
    }
}

⚠️ 注意事项

将尖括号中的占位符替换为实际值：
- CLIENT_ID：Azure AD 应用程序 ID。
- CLIENT_SECRET：Azure AD 客户端密码。
- TENANT_ID：Azure 目录（租户）ID。
- RESOURCE：Dynamics 365 实例 URL。
有关更多配置细节，请参考 Dynamics 365 和 Azure AD 的文档。

solyn_dynamics365_mcp_server