JinDaGe - mcp-dataverse MCP Details

article

README

🚀 MCP 服务器概述

MCP 服务器提供了两种便捷的使用方式：

Docker 容器
dotnet 工具

以下表格根据不同使用场景，为你推荐合适的 MCP 服务器版本： | 使用场景 | 客户端 | 推荐版本 | | ---- | ---- | ---- | | Windows | GitHub Copilot | dotnet 工具。若遇到身份验证问题，可将 Docker/Podman 作为备用方案。 | | Windows | Claude Desktop | dotnet 工具 | | macOS | Claude Desktop, GitHub Copilot | dotnet 工具 | | Linux | Claude Desktop, GitHub Copilot | dotnet 工具 | | GitHub Codespaces | GitHub Copilot | dotnet 工具 |

此 MCP 服务器采用 MCP C# SDK，并通过 nuget 以 dotnet 工具的形式分发。dotnet 9.0 SDK 支持在所有主流操作系统上进行安装。

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

dotnet tool install -g Mcp.Dataverse.Stdio

📦 安装指南

由于此 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 文件，并修改环境变量，具体步骤如下：

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

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

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

💻 使用示例

基础用法

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

获取未管理的解决方案

mcp get-unmanaged-solutions

显示按发布者的解决方案

mcp list-solutions-by-publisher

下载自定义表单

mcp download-forms

上传文件

mcp upload-files

创建新环境

mcp create-environment

mcp-dataverse