TradingView PineScript MCP Server

A Model Context Protocol (MCP) server for working with TradingView PineScript. This server provides tools for validating, fixing, and generating PineScript code through a standardized API.

Features

• PineScript Validation - Automatically validates PineScript code for syntax errors and warnings
• Error Fixing - Automatically fixes common PineScript syntax errors
• Template Generation - Provides validated templates for various PineScript strategies and indicators

Getting Started

Prerequisites

• Node.js 16.x or higher
• npm 8.x or higher

Installation

1. Clone the repository

git clone https://github.com/yourusername/pinescriptproject1.git
cd pinescriptproject1

2. Install dependencies

npm install

3. Build the project

npm run build

Running the Server

Start the MCP server:

npm run start-server

This will start the server with stdio transport, which allows it to communicate with MCP clients.

API

Tools

The MCP server exposes the following tools:

1. validate_pinescript

Validates PineScript code for syntax errors and warnings.

Parameters:

• script (string): The PineScript code to validate
• version (string, optional): Expected PineScript version (e.g., 'v5', 'v4')

Returns:

• valid (boolean): Whether the script is valid
• errors (string[]): List of syntax errors
• warnings (string[]): List of warnings

2. fix_pinescript_errors

Automatically fixes common syntax errors in PineScript code.

Parameters:

• script (string): The PineScript code to fix

Returns:

• fixed (boolean): Whether any fixes were applied
• fixedCode (string): The fixed script
• changes (string[]): List of changes made

3. get_pinescript_template

Provides validated templates for common PineScript strategies and indicators.

Parameters:

• template_type (string): Type of template ('strategy' or 'indicator')
• name (string): Template name

Returns:

• template (string): The template code
• message (string): Confirmation message

Supported PineScript Features

Syntax Validation

The validator currently checks for:

• Empty scripts
• Version annotations
• Balanced parentheses
• String quotes
• Comma placement in function calls
• Deprecated functions in PineScript v5
• Incorrect variable export syntax

Error Fixing

The fixer can automatically fix:

• Missing version annotations
• Unbalanced parentheses
• Unclosed string literals
• Missing commas in function calls
• Deprecated study() function
• Incorrect variable export syntax

Development

Running Tests

npm test

Debugging

To run the server in development mode with automatic reloading:

npm run dev

License

ISC

Contributing

Contributions are welcome!