微信扫一扫article
README
🚀 松树脚本 MCP 项目
松树脚本 MCP 项目是一个综合性工具，可用于创建、优化和管理松树脚本交易策略，为交易策略的开发和管理提供了便捷的解决方案。
🚀 快速开始
安装依赖
npm install
启动 UI（选择一种方法）
# 标准 Next.js 开发服务器
npm run ui
# 清理启动（杀死占用端口的进程）
npm run ui:clean
# 替代 Express 服务器（如果 Next.js 出现问题）
npm run ui:express
# 桌面应用程序（无需 Web 服务器）
npm run ui:electron
访问网络界面
http://localhost:3001
（桌面应用选项不需要此步骤）
✨ 主要特性
- 提供多种启动 UI 的方式，包括标准 Next.js 开发服务器、清理启动、替代 Express 服务器和桌面应用程序，满足不同场景需求。
- 具备丰富的实用工具脚本，涵盖服务器管理、网络诊断和文档生成等功能，方便开发和故障排除。
- 项目结构清晰，将核心代码、界面、文档、数据、测试等分开管理，便于维护和扩展。
📦 安装指南
安装依赖
npm install
启动 UI
可根据需求选择以下任意一种启动方式：
# 标准 Next.js 开发服务器
npm run ui
# 清理启动（杀死占用端口的进程）
npm run ui:clean
# 替代 Express 服务器（如果 Next.js 出现问题）
npm run ui:express
# 桌面应用程序（无需 Web 服务器）
npm run ui:electron
访问网络界面
若选择非桌面应用程序方式启动，可通过以下地址访问网络界面：
http://localhost:3001
📚 详细文档
UI 选项
该项目提供了多种访问 UI 的方式：
1. Next.js 开发服务器
# 标准 Next.js 开发服务器
npm run ui
# 清理启动（杀死占用端口的进程）
npm run ui:clean
# 使用管理员权限启动（解决顽固进程问题）
npm run ui:admin
2. 替代服务器选项
# 简单的 Express 服务器（更稳定的替代方案）
npm run ui:express
# 基本 HTML 测试页面服务器
npm run ui:test
3. 桌面应用程序
在 Web 服务器有连接问题的环境中：
# Electron 桌面应用程序（无需 Web 服务器）
npm run ui:electron
故障排除 UI 服务器
如果遇到 UI 服务器连接问题：
- 检查防火墙设置。
- 运行防火墙豁免脚本：
npm run firewall:allow。 - 查看
scripts/docs/ui-connect-guide.md获取详细连接故障排除指南。 - 尝试桌面应用选项：
npm run ui:electron。
实用工具脚本
该仓库包含多个实用工具脚本来帮助开发和故障排除：
必要服务器脚本（在 scripts/server/ 中）
run-ui-clean.bat- 主脚本用于启动 UI 服务器（清理现有进程）。run-ui-admin.bat- 使用管理员权限启动 UI 服务器。run-server.bat- 启动项目服务器。run-client.bat- 启动项目客户端。
网络相关脚本（在 scripts/network/ 中）
check-port.bat- 检查端口占用情况。kill-port.bat- 杀死占用端口的进程。network-test.bat- 进行网络连接测试。
文档脚本（在 scripts/docs/ 中）
generate-docs.bat- 生成项目文档。
开发信息
- Node.js 版本要求：v14.19.1 或更高版本。
- Yarn 版本要求：v1.22.5 或更高版本。
- 构建命令：
npm run build - 启动命令：
npm start
项目结构
├── src/ # 核心应用程序代码
├── ui/ # Next.js 网站界面
├── dist/ # 编译后的 JavaScript 文件
├── docs/ # 文档资料
├── scripts/ # 工具脚本
│ ├── server/ # 服务器管理脚本
│ ├── network/ # 网络诊断脚本
│ └── docs/ # 文档脚本
├── data/ # 数据文件
├── tests/ # 应用程序测试
├── examples/ # 示例脚本和策略
└── memory-bank/ # 项目上下文和信息
文档资料
有关如何使用和开发该项目的详细文档，请参阅 docs/ 目录中的文件。