项目简介

PineScript MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务器,专注于为 PineScript 交易策略提供上下文服务。它旨在简化 PineScript 策略的创建、优化和管理流程,通过标准化的 MCP 协议与客户端(如LLM应用)进行通信,提供代码验证、错误修复、格式化、版本控制和模板生成等核心功能。

主要功能点

  • PineScript 代码验证: 提供强大的 PineScript 代码语法验证功能,帮助开发者快速发现和修正脚本中的错误。
  • 自动错误修复: 集成自动错误修复工具,能够智能地修正 PineScript 代码中的常见语法问题。
  • 代码格式化: 支持代码格式化功能,统一代码风格,提高代码可读性和维护性。
  • 版本管理: 具备 PineScript 代码版本管理能力,方便用户追溯和管理策略脚本的不同版本。
  • 代码模版: 内置丰富的 PineScript 代码模版,加速策略开发过程。
  • 多协议支持: 通过 Stdio 进行通信,易于集成到各种 MCP 客户端。

安装步骤

  1. 安装 Node.js 和 npm: 确保您的系统已安装 Node.js (v18 或更高版本) 和 npm (v8 或更高版本)。
  2. 克隆仓库: 使用 Git 克隆 pinescript-mcp-server 仓库到本地。
    git clone https://github.com/cklose2000/pinescript-mcp-server.git
    cd pinescript-mcp-server
  3. 安装依赖: 在仓库根目录下运行 npm install 命令安装项目依赖。
    npm install
  4. 构建项目: 运行 npm run build 命令编译 TypeScript 代码。
    npm run build

服务器配置

MCP 客户端需要配置以下 JSON 格式信息以连接到 PineScript MCP Server:

{
  "serverName": "PineScriptMCP",
  "command": "node",
  "args": [
    "dist/index.js"
  ],
  "transport": "stdio",
  "protocol": "json-rpc"
}

配置参数说明:

  • 'serverName': 服务器名称,可以自定义,例如 "PineScriptMCP"。
  • 'command': 启动服务器的命令,这里使用 'node' 来运行 JavaScript 代码。
  • 'args': 启动命令的参数,指定服务器入口文件 'dist/index.js'。
  • 'transport': 传输协议,指定为 'stdio' 表示使用标准输入输出流进行通信。
  • 'protocol': 通信协议,指定为 'json-rpc' 表示使用 JSON-RPC 协议。

MCP 客户端配置示例 (以FastMCP客户端为例):

{
  "servers": [
    {
      "serverName": "PineScriptMCP",
      "command": "node",
      "args": [
        "path/to/pinescript-mcp-server/dist/index.js"
      ],
      "transport": "stdio",
      "protocol": "json-rpc",
      "tools": [
        "validate_pinescript",
        "fix_pinescript_errors",
        "get_pinescript_template",
        "convert_pinescript_version",
        "save_pinescript_version",
        "get_pinescript_history",
        "compare_pinescript_versions",
        "format_pinescript",
        "get_pinescript_config",
        "update_pinescript_config",
        "reset_pinescript_config",
        "get_config_section",
        "set_templates_directory",
        "test_connection"
      ]
    }
  ]
}

请将 'path/to/pinescript-mcp-server/dist/index.js' 替换为实际的 'dist/index.js' 文件路径。'tools' 数组列出了 PineScript MCP Server 提供的所有工具,客户端可以根据需要选择启用。

基本使用方法

  1. 启动 MCP 服务器: 在 pinescript-mcp-server 仓库根目录下,运行以下命令启动服务器:

    node dist/index.js

    服务器成功启动后,将通过 Stdio 监听 MCP 客户端的请求。

  2. 配置和启动 MCP 客户端: 根据 MCP 客户端 (例如 FastMCP) 的文档,配置服务器连接信息,并将客户端连接到正在运行的 PineScript MCP Server。

  3. 使用 MCP 客户端调用工具: 通过 MCP 客户端,您可以调用 PineScript MCP Server 提供的各种工具,例如:

    • 'validate_pinescript': 验证 PineScript 代码的语法。
    • 'fix_pinescript_errors': 自动修复 PineScript 代码中的错误。
    • 'format_pinescript': 格式化 PineScript 代码。
    • 'get_pinescript_template': 获取 PineScript 代码模版。
    • 'convert_pinescript_version': 转换 PineScript 代码版本。
    • 'save_pinescript_version': 保存 PineScript 代码版本。
    • 'get_pinescript_history': 获取 PineScript 代码版本历史。
    • 'compare_pinescript_versions': 比较 PineScript 代码版本差异。
    • 'get_pinescript_config': 获取服务器配置。
    • 'update_pinescript_config': 更新服务器配置。
    • 'reset_pinescript_config': 重置服务器配置为默认值。
    • 'get_config_section': 获取服务器配置的特定部分。
    • 'set_templates_directory': 设置模版目录。
    • 'test_connection': 测试服务器连接。

    具体工具的使用方法和参数,请参考 FastMCP 或其他 MCP 客户端的文档,并结合 pinescript-mcp-server 仓库中 'src/index.ts' 文件内对每个工具的参数定义。

注意: 请确保 MCP 客户端与 MCP 服务器版本兼容,并正确配置服务器连接信息。

信息

分类

开发者工具