多平台集成工具集

MCP顾问工具

模块化模型上下文协议（MCP）服务器，提供对Microsoft PowerPlatform、Azure DevOps、Figma、Azure监控服务、数据库和GitHub Enterprise的人工智能访问。

概述

MCP顾问工具是 模块化单仓库 和 22个独立发布的npm包 在...之下 @mcp-consultant-tools 组织。为特定集成安装单独的软件包，或为所有内容安装完整的元软件包。

PII保护（v32）： 内置4层编辑管道 powerplatform-data, azure-devops, azure-sql, rest-api，以及 azure-b2c 在针对客户生产环境的MCP工具调用期间，防止个人数据到达美国托管的LLM。它是 选择加入 --默认关闭；为每台服务器启用它 PII_PROTECTION=true。参见 docs/documentation/pii-protection.md.

• PII审核日志记录（选择加入）： 当通过启用时 MCP_AUDIT_LEVEL=lean|full，每一次调用都会生成一个防篡改的审计记录（阶段a——本地文件；阶段B——随后进行中央同步）。

包装架构

核心包

服务包

元包

故障排除：npx缓存问题

如果在切换包版本后遇到身份验证失败（例如，在 @beta 和 @latest)，清除npx缓存：

npx clear-npx-cache

然后重新启动MCP客户端。看 Azure DevOps故障排除 了解详情。

故障排除： npm error code E401 （无法进行身份验证）

症状 --MCP服务器无法启动，stderr尾部显示：

npm warn Unknown project config "always-auth". This will stop working in the next major version of npm.
npm error code E401
npm error Unable to authenticate, your authentication token seems to be invalid.
npm error To correct this please try logging in again with: npm login

这是npm未能通过包注册表的身份验证，而不是MCP服务器崩溃。 它发生在机器上（在咨询店/公司设置中很常见），在这些机器上，npm 默认注册表是私有提要 --Azure DevOps工件、GitHub包或内部Verdaccio/Nexus代理——通常与 always-auth=true 和一个 已过期的PAT.与 always-auth 在上，即使在获取公共数据时，npm也会尝试进行身份验证 @mcp-consultant-tools/* 包裹和死去的代币使其在之前爆炸 npx 曾经奔跑。这 always-auth 警告就是赠品。

修复（推荐）：将作用域固定到公共npm注册表

告诉npm @mcp-consultant-tools 作用域总是来自公共npm，不管默认注册表是什么。这是非破坏性的——它让私人提要为其他一切服务。

1. 打开（或创建）您的 用户级 .npmrc:
   • 窗户： C:\Users\<your-username>\.npmrc
   • macOS/Linux： ~/.npmrc
2. 添加此行：
   复制

   @mcp-consultant-tools:registry=https://registry.npmjs.org/
   

3. 验证（从任何目录运行）：
   复制

   npm config get @mcp-consultant-tools:registry
   # → should print: https://registry.npmjs.org/
   
   npm view @mcp-consultant-tools/azure-devops@beta version
   # → should print a version (e.g. 32.0.0-beta.2), NOT "npm error code E401"
   

4. 在MCP客户端中，重新连接服务器（在Claude代码中： /mcp → 重新连接或重新启动会话）。这 第一次发射很慢 当npx获取包时，它会连接。

诊断/替代修复

• 确认诊断 --强制公共注册表进行一次调用：
  复制

  npx --registry=https://registry.npmjs.org -y --package=@mcp-consultant-tools/PACKAGE BINARY --help
  

  如果这有效，那就是100% .npmrc /注册表配置问题。
• 检查违规配置 — cat ~/.npmrc （以及任何项目级别 .npmrc 在工作目录中）。寻找： always-auth=true一 registry=https://... 指向私人订阅源， //pkgs.dev.azure.com/...:_authToken=... （PAT过期），或流浪 @mcp-consultant-tools:registry= 指向公共npm以外的某个地方。
• 检查活动的默认注册表 — npm config get registry 必须返回 https://registry.npmjs.org/。如果它返回一个私有提要，而上面的作用域引脚不是一个选项，这就是根本原因。
• 存储/env var令牌 — npm logout 要清除存储的令牌，请重试。还要检查 env | grep -i npm — NPM_CONFIG_REGISTRY, NPM_TOKEN, NODE_AUTH_TOKEN 以（权力）否决 .npmrc.

npx clear-npx-cache 做 不 这里有帮助——缓存不是问题，注册表配置才是。

安装所有CLI工具

使用一个命令全局安装每个CLI工具。非常适合人工智能代理、调查工作流程和希望所有工具立即可用的开发人员。

# macOS / Linux
curl -sL https://raw.githubusercontent.com/klemensms/mcp-consultant-tools/main/docs/cli-setup/install-cli-tools.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/klemensms/mcp-consultant-tools/main/docs/cli-setup/install-cli-tools.ps1 | iex

安装后，所有21个CLI二进制文件都在您的PATH中，可以使用。通过传递凭据 --env-file .env 或 --mcp-server SERVER_NAME （读自 .mcp.json).

带有代理提示的完整设置指南： CLI安装指南

快速开始

选项1：个人套餐（推荐）

# Install only what you need
npx @mcp-consultant-tools/powerplatform

选项2：完整套餐

# All integrations in one package
npx mcp-consultant-tools

MCP客户端配置

每个软件包文档都包括完整的设置说明，以及Claude Desktop和VS Code的配置示例。请参阅 文档 上表中的列。

示例 （带克劳德桌面的PowerPlatform）：

{
  "mcpServers": {
    "powerplatform": {
      "command": "npx",
      "args": ["-y", "--package=@mcp-consultant-tools/powerplatform", "mcp-consultant-tools-powerplatform"],
      "env": {
        "POWERPLATFORM_URL": "https://yourenv.crm.dynamics.com",
        "POWERPLATFORM_CLIENT_ID": "your-client-id",
        "POWERPLATFORM_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

有关包括身份验证选项、权限和故障排除在内的完整设置，请参阅 PowerPlatform文档.

选项3:CLI使用

每个包还包括一个Commander.js CLI，用于基于shell访问相同的工具：

# Run any CLI via npx
npx --package=@mcp-consultant-tools/azure-devops mcp-ado-cli wiki list MyProject

# JSON output mode
npx --package=@mcp-consultant-tools/azure-devops mcp-ado-cli --json wiki list MyProject

# List all available CLIs
npx --package=mcp-consultant-tools mcp-tools-cli list

CLI工具使用与MCP服务器相同的环境变量。请参阅 CLI二进制文件 上表中的列。

AI代理的CLI访问（CLAUDE.md的复制粘贴）

如果您在另一个仓库中配置了MCP服务器，并希望代理/子代理也使用CLI工具（例如，在钩子、不继承MCP连接的子代理或shell脚本中），请将此添加到该仓库的 CLAUDE.md:

CLI工具（用于子代理、钩子和脚本）

MCP服务器配置为用于本机工具访问，但CLI等效物也可通过以下方式获得 npx 用于子代理（不继承MCP连接）、钩子和shell脚本。它们使用已为MCP服务器配置的相同环境变量。跑 npx --package=@mcp-consultant-tools/<package> <binary> --help 对于可用命令。常见CLIs： mcp-ado-cli （Azure DevOps）， mcp-pp-cli （PowerPlatform只读）， mcp-pp-custom-cli （PowerPlatform定制）， mcp-pp-data-cli （PowerPlatform数据）， mcp-ado-admin-cli （ADO管道/管理）， mcp-spo-cli （SharePoint）， mcp-sql-cli （Azure SQL）， mcp-appins-cli （应用洞察）， mcp-loganalytics-cli （日志分析）， mcp-storage-cli （Azure存储）， mcp-adf-cli （数据工厂）， mcp-azure-mgmt-cli （Azure管理）， mcp-ghe-cli （GitHub企业版）， mcp-azure-b2c-cli （Azure B2C）， mcp-sb-cli （服务巴士）， mcp-figma-cli （Figma）， mcp-fabric-cli （微软结构）， mcp-rest-api-cli （REST API）， mcp-teams-cli （团队）， mcp-audit-cli （审核日志验证/隔离/搜索）。使用 --json 适用于管道的原始JSON输出。

PowerPlatform安全拆分

PowerPlatform集成分为 3个安全隔离包:

安全性是通过软件包选择来实现的——只安装每个环境所需的软件包。

文档

设置指南（从这里开始）

每个集成都有全面的文档，包括快速入门、配置、工具参考和示例：

• PowerPlatform（只读）
• PowerPlatform定制
• PowerPlatform数据CRUD
• Azure DevOps
• Azure DevOps管理员
• Azure管理
• SharePoint在线
• GitHub企业版
• Figma
• 应用洞察
• 日志分析
• Azure SQL
• 服务总线
• Azure广告B2C
• Azure数据工厂
• Microsoft结构
• REST API

开发和技术指南

• 开发指南（CLAUDE.md） -架构、模式、贡献
• 发布过程 -发布工作流程
• 迁移指南 -在主要版本之间升级

发展

构建所有包

npm install
npm run build

构建个性化套餐

cd packages/powerplatform
npm run build

本地测试

{
  "mcpServers": {
    "local-dev": {
      "command": "node",
      "args": ["/path/to/mcp-consultant-tools/packages/powerplatform/build/index.js"],
      "env": { "..." }
    }
  }
}

链接

• npm： https://www.npmjs.com/org/mcp-consultant-tools
• github： https://github.com/klemensms/mcp-consultant-tools
• 问题： https://github.com/klemensms/mcp-consultant-tools/issues
• MCP协议： https://modelcontextprotocol.io

许可证

MIT许可证-请参阅 许可证 了解详情。