PineScript MCP Project

PineScript MCP 项目

用于创建、优化和管理 PineScript 交易策略的综合工具。

项目结构

├── src/             # Core application code
├── ui/              # Next.js web interface
├── dist/            # Compiled JavaScript
├── docs/            # Documentation
├── scripts/         # Utility scripts
│   ├── server/      # Server management scripts
│   ├── network/     # Network diagnostics scripts
│   └── docs/        # Documentation
├── data/            # Data files
├── tests/           # Application tests
├── examples/        # Example scripts and strategies
└── memory-bank/     # Project context and information

快速入门

1. 安装依赖项：

   npm install
   

2. 启动 UI（选择一种方式）：

   # Standard Next.js development server
   npm run ui
   
   # Clean start with port cleanup
   npm run ui:clean
   
   # Alternative Express server (if Next.js has issues)
   npm run ui:express
   
   # Desktop app (no web server required)
   npm run ui:electron
   

3. 访问 Web 界面：

   http://localhost:3001
   

   （桌面应用选项无需执行此操作）

UI 选项

本项目提供多种访问 UI 的方式：

1. Next.js 开发服务器

# Standard Next.js dev server
npm run ui

# Clean start (kills any existing processes using the ports)
npm run ui:clean

# Start with administrator privileges (for stubborn processes)
npm run ui:admin

2. 其他服务器选项

# Simple Express server (more stable alternative)
npm run ui:express

# Basic HTML test page server
npm run ui:test

3. 桌面应用

如果 Web 服务器存在连接问题，可使用以下选项：

# Electron desktop application (no web server required)
npm run ui:electron

UI 服务器故障排除

如果 UI 服务器出现连接问题：

1. 检查防火墙设置
2. 运行防火墙例外脚本：npm run firewall:allow
3. 查看 scripts/docs/ui-connect-guide.md，了解详细的连接故障排除方法
4. 尝试桌面应用选项：npm run ui:electron

实用脚本

此代码库包含多个实用脚本，可帮助开发和排查问题：

核心服务器脚本（位于 scripts/server/）

• run-ui-clean.bat - 启动 UI 服务器的主脚本（会清理现有进程）
• run-ui-admin.bat - 以管理员权限启动 UI 服务器
• serve-test-page.bat - 在端口 8000 上提供简单的 HTML 测试页面，用于测试连接
• run-express-server.bat - 启动 Express 服务器，作为 Next.js 的替代方案
• run-electron-app.bat - 启动 Electron 桌面应用（无需 Web 服务器）

网络故障排除（位于 scripts/network/）

• check-connectivity.bat - 全面的网络连接诊断
• check-windows-firewall.bat - 检查防火墙状态和规则
• allow-node-firewall.bat - 将 Node.js 添加到 Windows 防火墙例外列表
• test-network-connection.bat - 测试特定网络连接
• test-port-3000.bat - 测试端口 3000 是否可用
• kill-port-3000.bat - 结束所有正在使用端口 3000 的进程

文档（位于 scripts/docs/）

• ui-connect-guide.md - UI 连接故障排除综合指南
• README-UI.md - UI 专属文档

开发

前置条件

• Node.js（v18 或更高版本）
• npm（v8 或更高版本）

构建项目

npm run build

运行测试

npm test

功能

• 创建和编辑策略
• 回测功能
• 性能分析
• 策略优化
• TradingView 集成

Claude Desktop 集成

PineScript MCP 服务可与 Claude Desktop 集成，提供 AI 辅助的 PineScript 开发功能。

快速入门（macOS）

# Install and configure with one command
npx pinescript-mcp-server

# Or add to Claude Desktop
claude mcp add pinescript-server npx --args pinescript-mcp-server

快速入门（Windows）

# Add to Claude Desktop with Windows-specific wrapper
claude mcp add pinescript-server cmd --args /c npx pinescript-mcp-server

文档

如需详细的设置说明、平台专属配置和故障排除信息：

• 请参阅 CLAUDE_DESKTOP_SETUP.md

配置示例

• .mcp.json.example - 基本配置
• .mcp.json.mac.example - macOS 专属示例
• .mcp.json.windows.example - Windows 专属示例

Claude Desktop 中可用的功能

与 Claude Desktop 集成后，你可以：

• 创建和编辑 PineScript 策略
• 运行回测并分析性能
• 优化交易参数
• 生成兼容 TradingView 的代码
• 访问实时市场数据（需正确配置 API）

文档

详细文档请参阅 docs/ 目录：

• API 参考
• 用户指南
• 开发指南

许可证

本项目为专有且机密项目。

版权所有 © 2025。保留所有权利。