AI导哈

MCP服务器安装工具

用于安装和管理fabric-core、powerbi-modeling、translation-audit和azure-sql MCP服务器的GUI安装工具。

  • by Jasuni69
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Jasuni69/mcp-installer

使用说明

MCP服务器安装程序

用于结构核心、powerbi建模、翻译审计和azure sql MCP服务器的GUI安装程序。

终端用户计算机上不需要Python --下载 MCPInstaller.exe 从 发布 页面。

面向终端用户

  1. 下载 MCPInstaller.exe 从发布
  2. 运行它——无需安装
  3. 选择服务器，单击安装

先决条件（安装程序检查并告诉您缺少什么）：

对于开发者

生成exe：

pip install pyinstaller requests packaging
pyinstaller build.spec
# Output: dist/MCPInstaller.exe

从源代码运行（需要Python）：

pip install requests packaging
python installer.py

它做什么

  1. 克隆/更新 mcp-installer 安装目录的repo
  2. 跑动 uv sync 对于每个选定的服务器
  3. 写入 claude_desktop_config.json 和 ~/.claude/settings.json
  4. 将代理标记文件复制到 ~/.claude/agents/

安装后——重要步骤

%PATH和VSCode

Windows程序（uv、git、Azure CLI）将自己添加到系统中 %PATH 安装后。 VSCode快照 %PATH 一旦启动 并且在运行时不刷新它。

如果在此会话期间安装了任何必备项（uv、git、Azure CLI）：

  1. 关闭所有VSCode窗口 --每个人，而不仅仅是活跃的人
  2. 重新打开VSCode

“重新加载窗口”是不够的。 VSCode继承 %PATH 只有完全重新启动才能获取系统级PATH更改。这同样适用于任何终端（PowerShell、Windows终端、CMD）。

Claude Desktop--验证MCP服务器

安装后，必须完全重新启动Claude Desktop才能加载新的MCP配置：

  1. 退出克劳德桌面 --检查 系统托盘 （右下角）并单击鼠标右键→ Quit.仅仅关闭窗口可能会让它在后台运行。
  2. 重新打开克劳德桌面
  3. 首选 设置▸ 连接器
  4. 您安装的MCP服务器应显示在列表中（例如。 fabric-core, powerbi-modeling)

如果服务器在连接器中显示错误，请检查：

  • 是 uv 在你的路上？（安装uv后重新启动Claude Desktop）
  • Azure CLI是否经过身份验证？ (az login 在终端中）
  • 对于Power BI建模：是。是否安装了NET 9.x运行时？
  • 对于Azure SQL：是否安装了ODBC驱动程序18？

克劳德代码——验证MCP服务器

跑 claude 在任何终端。如果 uv 无法识别，请先重新启动终端。

使用 /mcp 在Claude Code内部检查哪些MCP服务器已连接。

存储凭据的位置

安装程序将MCP服务器配置（包括Azure SQL连接详细信息）写入 纯文本JSON文件:

客户端 配置文件
克劳德桌面 %APPDATA%\Claude\claude_desktop_config.json
克劳德代码（全球） ~/.claude/settings.json
克劳德代码（项目） <project>/.claude/settings.local.json

存储的内容：

  • Azure SQL服务器名称、数据库名称和身份验证方法
  • 如果使用SQL身份验证： 纯文本用户名和密码
  • Azure CLI身份验证(az_cli)不存储凭据--它使用您的 az login 运行时会话令牌

还存储（如果选择了Azure帐户）：

  • Azure租户ID和订阅ID作为服务器配置中的环境变量

未存储的内容：

  • 结构/Power BI令牌——在运行时通过Azure CLI登录获取

安全说明： 如果您使用SQL身份验证，您的密码将以纯文本形式保存在配置文件中。更喜欢 az_cli 尽可能进行身份验证。如果必须使用SQL身份验证，请确保配置文件未被共享或提交给版本控制。

要稍后更改凭据，只需使用新值重新运行安装程序——如果已经安装，它将跳过繁重的步骤。

故障排除

“uv：找不到命令”/“无法识别'uv'”

uv已安装，但您的终端尚未看到它。 关闭并重新打开终端 （或所有VSCode窗口）。新的 %PATH 仅由新启动的进程接收。

Claude Desktop未在连接器中显示我的服务器

  1. 确保完全退出Claude Desktop（系统托盘→ Quit)
  2. 重新打开并检查 设置▸ 连接器
  3. 如果服务器仍然缺失，请打开 %APPDATA%\Claude\claude_desktop_config.json 并验证 mcpServers 部分存在

Azure SQL服务器无法连接

  • 验证是否安装了ODBC驱动程序18（再次运行安装程序以检查先决条件）
  • 对于 az_cli auth:运行 az login 并确保您的帐户可以访问数据库
  • 对于 sql auth：仔细检查用户名、密码以及您的IP是否允许通过Azure SQL防火墙

Power BI建模服务器启动时崩溃

  • 必须安装.NET 9.x运行时： winget install Microsoft.DotNet.Runtime.9
  • TOM DLL必须存在于 powerbi-modeling/lib/ 或可通过NuGet缓存/SQLinstall发现
  • 如果使用本地连接模式，Power BI Desktop必须正在运行

“git clone”或“uv sync”挂起

安装程序对每个命令有5分钟的超时时间。如果您的网络速度较慢或位于代理服务器后面：

  • 检查您的互联网连接
  • 如果位于公司代理之后，请配置 git 和 uv 代理设置
  • 再试一次——瞬态网络问题很常见

Azure令牌过期/MCP工具停止工作

Azure CLI令牌将在几个小时后过期。如果MCP工具突然停止连接：

  1. 打开终端并运行 az login
  2. 重新启动Claude Desktop或您的终端

企业代理阻止git/uv

如果 git clone 或 uv sync 由于公司代理后面的连接错误而失败：

git config --global http.proxy http://proxy.company.com:8080
git config --global https.proxy http://proxy.company.com:8080

对于uv，设置环境变量：

set HTTPS_PROXY=http://proxy.company.com:8080

Azure SQL:“无法打开服务器”/连接被拒绝

您的IP可能不在Azure SQL防火墙允许列表中：

  1. 转到Azure门户→ 您的SQL Server→ 网络
  2. 添加您当前的IP地址（或启用“允许Azure服务”）
  3. 保存并重试

机翼安装失败，“拒绝访问”

某些软件包需要管理员权限。右键单击安装程序（或终端）并选择 以管理员身份运行，然后重试。

强制重新安装（.vnv已损坏）

如果 uv sync 中途失败，留下了一个破碎的环境，检查 “强制重新安装” 在安装程序中单击“安装”之前。这将删除现有 .venv 文件夹，并从头开始重新创建它们。

带有空格或特殊字符的路径

安装程序处理带有空格的路径（例如。 C:\Users\John Smith\.mcp-servers).如果遇到问题，请尝试没有空格的安装位置（例如。 C:\mcp-servers).

相关 MCP