PineScript MCP Project

A comprehensive tool for creation, optimization, and management of PineScript trading strategies.

Project Structure

├── 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

Quick Start

1. Install dependencies:

npm install

2. Start the UI (choose one method):

# 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. Access the web interface at:

http://localhost:3001

(Not required for the desktop app option)

UI Options

The project includes multiple ways to access the UI:

1. Next.js Development Server

# 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. Alternative Server Options

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

# Basic HTML test page server
npm run ui:test

3. Desktop Application

For environments where web servers have connectivity issues:

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

Troubleshooting UI Server

If you experience connection issues with the UI server:

1. Check your firewall settings

2. Run the firewall exception script: `npm run firewall:allow`

3. See the `scripts/docs/ui-connect-guide.md` for detailed connection troubleshooting

4. Try the desktop app option: `npm run ui:electron`

Utility Scripts

The repository includes several utility scripts to help with development and troubleshooting:

Essential Server Scripts (in scripts/server/)

• `run-ui-clean.bat` - Main script to start the UI server (cleans up existing processes)
• `run-ui-admin.bat` - Starts the UI server with administrator privileges
• `serve-test-page.bat` - Serves a simple HTML test page on port 8000 to test connectivity
• `run-express-server.bat` - Starts an Express server as an alternative to Next.js
• `run-electron-app.bat` - Starts the Electron desktop application (no web server required)

Network Troubleshooting (in scripts/network/)

• `check-connectivity.bat` - Comprehensive network connectivity diagnostics
• `check-windows-firewall.bat` - Check firewall status and rules
• `allow-node-firewall.bat` - Add Node.js to Windows Firewall exceptions
• `test-network-connection.bat` - Test specific network connections
• `test-port-3000.bat` - Test if port 3000 is available
• `kill-port-3000.bat` - Kill any process using port 3000

Documentation (in scripts/docs/)

• `ui-connect-guide.md` - Comprehensive guide to UI connectivity troubleshooting
• `README-UI.md` - UI-specific documentation

Development

Prerequisites

• Node.js (v18 or higher)
• npm (v8 or higher)

Building the Project

npm run build

Running Tests

npm test

Features

• Strategy creation and editing
• Backtesting capabilities
• Performance analysis
• Strategy optimization
• TradingView integration

Claude Desktop Integration

The PineScript MCP Server can be integrated with Claude Desktop to provide AI-assisted PineScript development capabilities.

Quick Start (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

Quick Start (Windows)

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

Documentation

For detailed setup instructions, platform-specific configurations, and troubleshooting:

• See CLAUDE_DESKTOP_SETUP.md

Example Configurations

• .mcp.json.example - Basic configuration
• .mcp.json.mac.example - macOS-specific example
• .mcp.json.windows.example - Windows-specific example

Features Available in Claude Desktop

When integrated with Claude Desktop, you can:

• Create and edit PineScript strategies
• Run backtests and analyze performance
• Optimize trading parameters
• Generate TradingView-compatible code
• Access real-time market data (with proper API configuration)

Documentation

See the `docs/` directory for detailed documentation on:

• API Reference
• User Guide
• Development Guide

License

This project is proprietary and confidential.

Copyright © 2025. All rights reserved.