🚀 MCP 服务器概述

MCP 服务器为开发者提供了便捷的使用体验，主要有以下两种使用方式：

1. Docker 容器
2. dotnet 工具

下表根据不同的使用场景，为你推荐合适的 MCP 服务器版本：

此 MCP 服务器借助 MCP C# SDK 运行，它通过 nuget 以 dotnet 工具的形式分发。dotnet 9.0 SDK 可在所有主流操作系统上安装。

你可以使用以下命令将 Dataverse MCP 服务器作为 dotnet 工具进行全局安装：

dotnet tool install -g Mcp.Dataverse.Stdio

📦 安装指南

dotnet 工具安装

由于此 MCP 服务器使用 MCP C# SDK 并通过 nuget 分发为 dotnet 工具，dotnet 9.0 SDK 可在所有主要操作系统上安装。你可以使用以下命令全局安装 Dataverse MCP 服务器作为 dotnet 工具：

dotnet tool install -g Mcp.Dataverse.Stdio

⚙️ 配置

容器运行配置

如果你选择在容器内运行 MCP 服务器，可参考以下示例 .env 文件。需在工作区文件夹（与 README.md 同级）创建 .env 文件。

AZURE_CLIENT_ID=aba9829f-6288-44d7-9168-53eca9a1f4a5
AZURE_CLIENT_SECRET=abcd
AZURE_TENANT_ID=2caa17e6-884b-473b-80c5-c05d8859a2fa
DATAVERSE_ENVIRONMENT_URL=https://abc.crm6.dynamics.com
DOCKER_CONTAINER=true

新文件夹使用配置

如果你在新的文件夹（不在克隆的代码仓库中）使用此 MCP 服务器，请确保 .github/copilot-instructions.md 文件已设置。若你已有一个不同的 copilot-instructions.md 文件，也可以将其作为自定义提示创建到 .github/prompts 文件夹中，例如 dataverse.main.prompt.md，并在聊天中使用它。

📚 MCP 配置示例

{
    "servers": {
        "dataverse-mcp-dotnet-tool": {
            "type": "stdio",
            "command": "mcp-dataverse",
            "env": {
                "DATAVERSE_ENVIRONMENT_URL": "https://abc.crm6.dynamics.com"
            }
        }
    }
}

🌐 GitHub Codespaces 配置

选择特定的 devcontainer.json 文件，并修改环境变量，具体步骤如下：

1. 打开 VS Code 并进入你的项目。
2. 在资源管理器中，找到 .devcontainer 文件夹。
3. 打开 devcontainer.json 文件，添加以下内容到 "extensions" 数组：

{
    "id": "ms-vscode.cmake-tools"
}

4. 保存文件并重新加载工作区。

💻 使用示例

基本用法

以下展示了如何使用 MCP 进行各种操作：

1. 获取未管理的解决方案：

mcp get-unmanaged-solutions

2. 显示按发布者的解决方案：

mcp list-solutions-by-publisher

3. 下载自定义表单：

mcp download-forms

4. 上传文件：

mcp upload-files

5. 创建新环境：

mcp create-environment