【小技巧】Python + PyCharm 小智AI配置MCP接入点使用说明（内测）（ PyInstaller打包成 .exe 可执行文件）
- https://xiaozhi.me/console/agents/17986/config
- 小智AI配置MCP接入点使用说明（内测）
- MCP Sample Project | MCP 示例项目
【小技巧】Python+PyCharm IDE 配置解释器出错，环境配置不完整或不兼容。(小智AI、MCP、聚合数据、实时新闻查询、NBA赛事查询)
设置环境变量遇到过大问题：
- 使用 PowerShell
- 打包成
.exe
Python 脚本打包成 .exe 可执行文件，最常用工具是 PyInstaller。下面是详细的依赖包、安装命令和常用打包指令说明。
安装依赖包
使用 PyInstaller：
pip install pyinstaller
基本打包命令
假设你的脚本叫 calculator.py：
pyinstaller --onefile calculator.py
打包完成后会生成：
dist/└── calculator.exe
常用参数说明
| 参数 | 说明 |
|---|---|
--onefile | 打包成单个 .exe 文件 |
--noconsole | 不显示命令行窗口（适用于 GUI 程序） |
--icon=xxx.ico | 指定图标文件 |
--name=自定义名称 | 指定打包后的 EXE 名称 |
示例（带图标和重命名）：
pyinstaller --onefile --name=mcp_tool --icon=myicon.ico calculator.py
注意事项
-
打包后的
.exe会很大，因为包含了 Python 解释器和依赖库。 -
如果脚本用到了外部文件（如
.env或配置文件），需通过--add-data指定：pyinstaller --onefile --add-data ".env;." calculator.py -
如果有多个模块、第三方库，请确保它们都正确安装在当前 Python 环境中。
安装后的目录结构
dist/ # 打包后的 EXE
build/ # 临时构建文件
calculator.spec # PyInstaller 的配置文件
如何将这两个文件打包成.exe文件，只需要点击一个.exe文件就可以同时运行这两个文件
python mcp_pipe.py calculator.py 这条命令实际上运行了两个 Python 文件，但 控制主逻辑的是 mcp_pipe.py，它 作为“中间转发器” 。
你可以使用 PyInstaller 将整个 mcp_pipe.py + calculator.py 项目打包为一个单独的 .exe 可执行文件，只生成一个 .exe，运行后自动完成启动和通信过程。以下是完整的打包流程与注意事项：
打包指令
在 mcp_pipe.py 所在目录打开 PowerShell，执行：
pyinstaller --onefile --add-data "calculator.py;." mcp_pipe.py
说明：
-
--onefile：打成一个单独的exe -
--add-data：把calculator.py一起打包进去- Windows 下用
;分隔路径 - Linux/macOS 下用
:
- Windows 下用
打包完成后：
生成目录结构如下：
dist/
└── mcp_pipe.exe ✅ 你要的单文件
你可以将 mcp_pipe.exe 重命名为 mcp_client.exe。
使用方式
只需双击 mcp_client.exe 或命令行运行：
mcp_client.exe
程序将自动：
- 读取环境变量
MCP_ENDPOINT - 启动内部的
calculator.py - 与云端通信，响应请求
⚠️ 注意事项：
-
calculator.py被打包进去是静态文件，如需后期更新工具功能，必须重新打包。 -
环境变量
MCP_ENDPOINT仍需通过：$env:MCP_ENDPOINT="wss://api.xxxx.com/..."或写入
.env文件并在calculator.py中load_dotenv()。 -
如果有
requests、dotenv、mcp等第三方依赖，请确保requirements.txt已完整，打包前测试无误。
- 打包成
.bat
自动运行的 .bat 脚本内容（保存为 mcp_endpoint_run.bat）：
@echo off
set MCP_ENDPOINT=你的xx
start "" mcp_pipe.exe
powershell (Add-Type -MemberDefinition @"[DllImport("user32.dll")]public static extern int SendMessage(int hWnd, int hMsg, int wParam, int lParam);
"@ -Name "Win32SendMessage" -Namespace Win32Functions -PassThru)::SendMessage(-1, 0x0112, 0xF170, 2)