MCP Dataverse

🚀 MCP サーバーの概要

MCP サーバーには、以下の2つの使用方法があります。

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

✨ 主な機能

この MCP サーバーは、MCP C# SDK を使用しており、nuget を通じて dotnet ツールとして配布されています。dotnet 9.0 SDK を使用することで、主要なオペレーティングシステムで動作します。

📦 インストール

dotnet ツールとしてのインストール

以下のコマンドを使用して、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 を使用した様々な操作の例です。

# 未管理のソリューションを取得
mcp get-unmanaged-solutions

# 発行者別のソリューションを表示
mcp list-solutions-by-publisher

# カスタムフォームをダウンロード
mcp download-forms

# ファイルをアップロード
mcp upload-files

# 新しい環境を作成
mcp create-environment