What is Pinescript Mcp Server

The pinescript-mcp-server is a Model Context Protocol (MCP) server designed for working with TradingView PineScript. It provides tools for validating, fixing, and generating PineScript code through a standardized API.

Use cases

Use cases include validating and fixing PineScript code for traders and developers, generating templates for new strategies or indicators, and ensuring compliance with PineScript syntax standards.

How to use

To use the pinescript-mcp-server, first ensure you have Node.js 16.x or higher and npm 8.x or higher installed. Clone the repository, install dependencies, build the project, and then start the server using npm commands.

Key features

Key features include PineScript validation for syntax errors, automatic fixing of common syntax errors, and the generation of validated templates for various PineScript strategies and indicators.

Where to use

The pinescript-mcp-server can be used in financial trading environments where TradingView PineScript is utilized, particularly for developing trading strategies and indicators.

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!