Skip to content
Back to search

pinescript-mcp-server

A Model Context Protocol (MCP) server for working with TradingView PineScript

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cklose2000--pinescript-mcp-server/badge.svg)](/listings/cklose2000--pinescript-mcp-server)

HTML

<a href="/listings/cklose2000--pinescript-mcp-server"><img src="/api/listings/cklose2000--pinescript-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 193 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # PineScript MCP Project
  2. A comprehensive tool for creation, optimization, and management of PineScript trading strategies.
  3. ## Project Structure
  4. ```
  5. ├── src/ # Core application code
  6. ├── ui/ # Next.js web interface
  7. ├── dist/ # Compiled JavaScript
  8. ├── docs/ # Documentation
  9. ├── scripts/ # Utility scripts
  10. │ ├── server/ # Server management scripts
  11. │ ├── network/ # Network diagnostics scripts
  12. │ └── docs/ # Documentation
  13. ├── data/ # Data files
  14. ├── tests/ # Application tests
  15. ├── examples/ # Example scripts and strategies
  16. └── memory-bank/ # Project context and information
  17. ```
  18. ## Quick Start
  19. 1. Install dependencies:
  20. ```
  21. npm install
  22. ```
  23. 2. Start the UI (choose one method):
  24. ```
  25. # Standard Next.js development server
  26. npm run ui
  27. # Clean start with port cleanup
  28. npm run ui:clean
  29. # Alternative Express server (if Next.js has issues)
  30. npm run ui:express
  31. # Desktop app (no web server required)
  32. npm run ui:electron
  33. ```
  34. 3. Access the web interface at:
  35. ```
  36. http://localhost:3001
  37. ```
  38. (Not required for the desktop app option)
  39. ## UI Options
  40. The project includes multiple ways to access the UI:
  41. ### 1. Next.js Development Server
  42. ```bash
  43. # Standard Next.js dev server
  44. npm run ui
  45. # Clean start (kills any existing processes using the ports)
  46. npm run ui:clean
  47. # Start with administrator privileges (for stubborn processes)
  48. npm run ui:admin
  49. ```
  50. ### 2. Alternative Server Options
  51. ```bash
  52. # Simple Express server (more stable alternative)
  53. npm run ui:express
  54. # Basic HTML test page server
  55. npm run ui:test
  56. ```
  57. ### 3. Desktop Application
  58. For environments where web servers have connectivity issues:
  59. ```bash
  60. # Electron desktop application (no web server required)
  61. npm run ui:electron
  62. ```
  63. ### Troubleshooting UI Server
  64. If you experience connection issues with the UI server:
  65. 1. Check your firewall settings
  66. 2. Run the firewall exception script: `npm run firewall:allow`
  67. 3. See the `scripts/docs/ui-connect-guide.md` for detailed connection troubleshooting
  68. 4. Try the desktop app option: `npm run ui:electron`
  69. ## Utility Scripts
  70. The repository includes several utility scripts to help with development and troubleshooting:
  71. ### Essential Server Scripts (in scripts/server/)
  72. - `run-ui-clean.bat` - Main script to start the UI server (cleans up existing processes)
  73. - `run-ui-admin.bat` - Starts the UI server with administrator privileges
  74. - `serve-test-page.bat` - Serves a simple HTML test page on port 8000 to test connectivity
  75. - `run-express-server.bat` - Starts an Express server as an alternative to Next.js
  76. - `run-electron-app.bat` - Starts the Electron desktop application (no web server required)
  77. ### Network Troubleshooting (in scripts/network/)
  78. - `check-connectivity.bat` - Comprehensive network connectivity diagnostics
  79. - `check-windows-firewall.bat` - Check firewall status and rules
  80. - `allow-node-firewall.bat` - Add Node.js to Windows Firewall exceptions
  81. - `test-network-connection.bat` - Test specific network connections
  82. - `test-port-3000.bat` - Test if port 3000 is available
  83. - `kill-port-3000.bat` - Kill any process using port 3000
  84. ### Documentation (in scripts/docs/)
  85. - `ui-connect-guide.md` - Comprehensive guide to UI connectivity troubleshooting
  86. - `README-UI.md` - UI-specific documentation
  87. ## Development
  88. ### Prerequisites
  89. - Node.js (v18 or higher)
  90. - npm (v8 or higher)
  91. ### Building the Project
  92. ```bash
  93. npm run build
  94. ```
  95. ### Running Tests
  96. ```bash
  97. npm test
  98. ```
  99. ## Features
  100. - Strategy creation and editing
  101. - Backtesting capabilities
  102. - Performance analysis
  103. - Strategy optimization
  104. - TradingView integration
  105. ## Claude Desktop Integration
  106. The PineScript MCP Server can be integrated with Claude Desktop to provide AI-assisted PineScript development capabilities.
  107. ### Quick Start (macOS)
  108. ```bash
  109. # Install and configure with one command
  110. npx pinescript-mcp-server
  111. # Or add to Claude Desktop
  112. claude mcp add pinescript-server npx --args pinescript-mcp-server
  113. ```
  114. ### Quick Start (Windows)
  115. ```bash
  116. # Add to Claude Desktop with Windows-specific wrapper
  117. claude mcp add pinescript-server cmd --args /c npx pinescript-mcp-server
  118. ```
  119. ### Documentation
  120. For detailed setup instructions, platform-specific configurations, and troubleshooting:
  121. - See [CLAUDE_DESKTOP_SETUP.md](./CLAUDE_DESKTOP_SETUP.md)
  122. ### Example Configurations
  123. - [.mcp.json.example](./.mcp.json.example) - Basic configuration
  124. - [.mcp.json.mac.example](./.mcp.json.mac.example) - macOS-specific example
  125. - [.mcp.json.windows.example](./.mcp.json.windows.example) - Windows-specific example
  126. ### Features Available in Claude Desktop
  127. When integrated with Claude Desktop, you can:
  128. - Create and edit PineScript strategies
  129. - Run backtests and analyze performance
  130. - Optimize trading parameters
  131. - Generate TradingView-compatible code
  132. - Access real-time market data (with proper API configuration)
  133. ## Documentation
  134. See the `docs/` directory for detailed documentation on:
  135. - API Reference
  136. - User Guide
  137. - Development Guide
  138. ## License
  139. This project is proprietary and confidential.
  140. Copyright © 2025. All rights reserved.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.