🚀 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