Pinescript_syntax_checker

🚀 PineScript语法检查器MCP服务器

这是一个基于模型上下文协议（MCP）的服务器，借助TradingView的API来检查PineScript代码的语法。它能让你轻松验证PineScript代码的正确性，提升开发效率。

✨ 主要特性

• 利用TradingView官方API检查PineScript语法。
• 基于httpx实现MCP兼容服务器，支持异步HTTP请求。
• 提供详细的错误报告，包含错误所在的行号和列号信息。

🚀 快速开始

选项1：使用uvx（推荐）

# 直接运行（若需要会自动安装）
uvx pinescript-syntax-checker

选项2：使用uv（开发模式）

# 克隆仓库并运行
git clone https://github.com/erevus-cn/pinescript-syntax-checker.git
cd pinescript-syntax-checker
uv sync
uv run python -m pinescript_syntax_checker.server

选项3：使用pip

# 从PyPI安装
pip install pinescript-syntax-checker

# 直接运行
pinescript-syntax-checker

# 或者作为模块运行
python -m pinescript_syntax_checker.server

📚 MCP集成

在Cursor中配置

若要在Cursor中使用此MCP服务器，请按以下步骤操作：

1. 打开Cursor设置：

   • 在macOS系统中，按下Cmd + ,；在Windows/Linux系统中，按下Ctrl + ,。
   • 进入“扩展” → “MCP”。

2. 添加服务器配置：

   方法1 - 使用uvx（推荐）：

   {
   "mcpServers": {
   "pinescript-syntax-checker": {
   "command": "uvx",
   "args": ["pinescript-syntax-checker"]
   }
   }
   }
   

   方法2 - 使用已安装的包：

   {
   "mcpServers": {
   "pinescript-syntax-checker": {
   "command": "python",
   "args": ["-m", "pinescript_syntax_checker.server"]
   }
   }
   }
   

3. 重启Cursor 以加载MCP服务器。

验证安装

若要验证MCP服务器是否正常工作，请按以下步骤操作：

1. 在Cursor中：配置完成后，尝试询问：

   Can you check this PineScript code for syntax errors?
   
   //@version=5
   indicator("Test", overlay=true)
   plot(close)
   

📄 API文档

check_syntax

使用TradingView的API检查PineScript语法。

参数：

• pine_code（字符串）：需要检查的PineScript代码。

💻 使用示例

基础用法

输入：

//@version=5
strategy("Test")
plot(close)

输出：

{
"success": true,
"result": {
"variables": [],
"functions": [],
"types": [],
"enums": [],
"scopes": []
}
}

📄 许可证

本项目采用MIT许可证。