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

Related MCP server: PineScript Docs

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!