返回市场
基因脚本包安装配件_mCP

基因脚本包安装配件_mCP

作者:rajyraman4 星标更新:2025-04-03

项目介绍

Power Platform CLI, Graph API 和 Azure REST API - MCP

此仓库包含使用 Graph API、Azure REST API(通过 Azure CLI)以及 Power Platform Admin APIs/Dataverse APIs(通过 Power Platform CLI)的模型上下文协议(MCP)工具。

预备条件

  1. VSCode Insiders - 2025年3月版本或 Claude Desktop
  2. 安装并认证了 Azure CLI 和 Power Platform CLI 的本地机器(如果你不使用 DevContainer 选项)。
  3. 如果你想在 Dev Container 中运行 MCP,需要安装 Dev Container CLI
  4. 如果你想运行 Dev Containers,需要安装 Docker

什么是 GenAIScript? 🤖

GenAIScript 是一个框架,它使你能够与 AI 模型(甚至是本地模型)进行通信。GenAIScript 可以使用 MCP 工具,并且也可以充当 MCP 服务器。

模型上下文协议(MCP) 📋

这是 Anthropic(MCP 规范的创建者)对 模型上下文协议 的定义:

MCP 是一个开放协议,标准化了应用程序如何向大语言模型提供上下文。你可以把 MCP 想象成 AI 应用程序的 USB-C 端口。就像 USB-C 提供了一种标准化的方式,让你的设备连接到各种外围设备和配件一样,MCP 提供了一种标准化的方式,让 AI 模型连接到不同的数据源和工具。

安装 🛠️

  • 安装 NodeJS
  • 使用 npm install -g genaiscript 安装 genaiscript CLI,或者使用 npx genaiscript

使用方法 💻

如果你安装了 2025 年 3 月版本的 VSCode Insiders,你应该能够在本地运行 GenAIScript MCP 服务器,以获取已安装在本地机器上的工具版本。

mcp.json 是你配置 MCP 服务器的地方。你甚至不需要克隆这个仓库,因为 GenAIScript 可以为你在后台克隆仓库,只需使用工具即可。如果你使用 --remote 标志,你完全不需要安装 GenAIScript 扩展,因为 npx 会为你拉取所有内容。

已知问题 - Windows 上的 Copilot ⚠️

GitHub Copilot 不喜欢在 VSCode Insiders 中尝试进行身份验证的 CLI。如果你尝试这样做,Power Platform CLI 将会失败,并显示错误信息:无法加载或初始化请求的服务提供商

你有两个选择:

  1. 在 DevContainers 中运行整个仓库。此仓库指定了 .devcontainer.json 配置文件。如果你使用此选项,可以在 .devcontainer 文件夹中创建一个名为 genaiscript.env 的新文件。以下是一个示例。
PAC_CLIENT_ID=2caa17e6-884b-473b-80c5-c05d8859a2fa
PAC_CLIENT_SECRET=
ENVIRONMENT_URL=https://abc.crm6.dynamics.com
TENANT_ID=
AZ_CLIENT_ID=aba9829f-6288-44d7-9168-53eca9a1f4a5
AZ_CLIENT_SECRET=
DOCKER_CONTAINER=true
  1. 使用 Claude Desktop 运行 MCP。Claude Desktop 在 Windows 上不会遇到这个问题。

Claude Desktop 配置 🧠

<u>Windows 配置</u>

{
    "globalShortcut": "Ctrl+Space",
    "mcpServers": {
        "genaiscript-mcp": {
            "type": "stdio",
            "command": "cmd",
            "args": [
                "/c",
                "npx",
                "genaiscript",
                "mcp",
                "--remote",
                "https://github.com/rajyraman/genaiscript-pac-az-mcp/",
                "--remote-branch",
                "main",
                "--groups",
                "mcp",
                "--startup",
		"mcp_resources"
            ],
            "env": {
                "DEBUG": "*"
            }
        }
    }
}

<u>MacOS/Linux 配置</u>

{
    "globalShortcut": "Ctrl+Space",
    "mcpServers": {
        "genaiscript-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "genaiscript",
                "mcp",
                "--remote",
                "https://github.com/rajyraman/genaiscript-pac-az-mcp/",
                "--remote-branch",
                "main",
                "--groups",
                "mcp",
                "--startup",
		"mcp_resources"
            ],
            "env": {
                "DEBUG": "*"
            }
        }
    }
}

VSCode 配置 🧩

VSCode Insiders 中的 MCP 配置是通过 .vscode 文件夹中的 mcp.json 文件进行的。 <u>Windows 配置</u>

直接运行 npx 在 Windows 上似乎会产生问题。因此,我们必须使用 cmd 来启动 npx

{
    "servers": {
        "genaiscript-mcp-remote": {
            "type": "stdio",
            "command": "cmd",
            "args": [
                "/c",
                "npx",
                "genaiscript",
                "mcp",
                "--remote",
                "https://github.com/rajyraman/genaiscript-pac-az-mcp/",
                "--remote-branch",
                "main",
                "--groups",
                "mcp"
            ],
            "env": {
                "DEBUG": "*"
            }
            // "envFile": "${workspaceFolder}/.env"
        }
    }
}

<u>MacOS/Linux 配置</u>

{
    "servers": {
        "genaiscript-mcp-remote": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "genaiscript",
                "mcp",
                "--remote",
                "https://github.com/rajyraman/genaiscript-pac-az-mcp/",
                "--remote-branch",
                "main",
                "--groups",
                "mcp"
            ],
            "env": {
                "DEBUG": "*"
            }
            // "envFile": "${workspaceFolder}/.env"
        }
    }
}

你可以通过点击“开始”链接来启动 MCP 服务器。如果它已经在运行,你会看到一个“正在运行”的指示器。

MCP 服务器启动

MCP 工具

提示文件

使用 az.prompt.md 对于任何 Azure REST API 或 Graph API 的问题。

使用 pac.prompt.md 对于任何 Power Platform 的问题。

你可以在 VSCode 中像下面这样使用提示。

提示1 提示2 提示3

在 Claude Desktop 中,你可以将提示文件上传到会话。提示作为资源可用。选择你计划询问 Claude 的适当提示。如果需要,你可以选择两者,但最好先选择一个,测试体验后再选择两者。

Claude 文件

PAC 提示

AZ 提示

以下是您如何在 GitHub Copilot 聊天中使用它的示例。

示例 1 - 查询 Power Platform 环境详细信息

Copilot PAC

示例 2 - 查询 Azure 订阅详细信息

Copilot Azure REST API

示例 3 - 查询 Graph API 详细信息

Copilot Graph API

示例 4 - 查询 Claude Desktop 中的 Power Platform 环境

Claude Desktop