Pine Script v6 MCP Server

Pine Script v6 MCP（manual.json 利用）

Repository: https://github.com/harunamitrader/pinescriptV6_MCP

Pine Script v6 のリファレンスマニュアルを JSON 化した manual.json を用いて、Claude Code / Codex CLI / Gemini CLI などの MCP クライアントから正確な Pine Script コーディングを支援するシンプルな MCP サーバです。

目的: 正確な API 仕様・定数名・用例への素早いアクセス
前提: manual.json（UTF-8, v6, ja）を同梱済み
方針: 最小依存・読み取り専用・メモリ内インデックス

機能概要

stdio ベースの MCP サーバ（Node.js）
起動時に manual.json を読み込み、軽量インデックスを構築
提供ツール
- search_docs: クエリで関数/定数/アノテーション等を横断検索
- get_entry: id で単一エントリの詳細（最小情報）を取得
- complete_symbol: プレフィックス補完（例: plot, ta.r, color.）
- list_categories: 種別ごとの件数集計（annotation/const/function/type 等）

返却は LLM が引用しやすい JSON（structuredContent を含む）です。

ツール詳細（AIコーディング視点）

search_docs: あいまい探索に最適
- 用途: 正式名称が曖昧／断片だけ分かるときの横断検索。
- 強み: 前方一致優先＋部分一致で広く当たりを取得。kind で絞り込み可。
- 例: {"query":"plot"} / {"query":"ta.r","kind":"function"}
- 活用: 新規実装の関数候補を洗い出し、未知のアノテーションや定数を探索。
get_entry: コード確定前の最終確認
- 用途: 検索/補完で特定した id の詳細確認（タイトル・種別・URL、将来的にシグネチャ等）。
- 強み: LLM が structuredContent をそのまま参照でき、引数名や戻り値の取り違えを抑制。
- 例: {"id":"fun_color.b"} → color.b() の詳細を返却。
- 活用: 実装直前の仕様チェック、レビュー時の根拠提示（source_url 付き）。
complete_symbol: 名前空間ベースの高速補完
- 用途: コーディング中に ta. や color. のような接頭辞から候補を即時取得。
- 強み: 前方一致で低オーバーヘッド。名前空間配下の網羅把握にも便利。
- 例: {"prefix":"color."} / {"prefix":"strategy.","limit":50}
- 活用: 実装中の記述補助、同名関数が多い領域の候補比較。
list_categories: 全体像の把握と探索起点作り
- 用途: annotation/const/function/type など、領域ごとの件数を把握。
- 強み: ドキュメントの偏りや対象範囲を俯瞰でき、検索条件の当たりを付けやすい。
- 例: 引数なしで呼び出し。戻り値は {kind,count} の配列。
- 活用: 初学者のナビゲーション、探索開始時のスコープ設定。

おすすめ構成（CLI で AI が効率良くコーディングする前提）

コンパクト重視: complete_symbol + get_entry
横断探索重視: search_docs + get_entry
快適性重視: search_docs + complete_symbol + get_entry（通常はこれで十分）
補助: 必要に応じて list_categories を追加

インストール / 実行

クローン導入（推奨）

git clone https://github.com/harunamitrader/pinescriptV6_MCP.git
cd pinescriptV6_MCP/pinescriptMCP

依存インストール

npm i

起動（手動起動の例）

node server.mjs --manual ./manual.json
# 既存の別の manual.json を使う場合
node server.mjs --manual C:/path/to/manual.json

環境変数 PINE_MANUAL_PATH でも指定できます。

Codex CLI 設定（TOML）

~/.codex/config.toml に以下を追記します。

[mcp_servers]
[mcp_servers.pinescript_mcp]
command = "C:/Program Files/nodejs/node.exe"
args = [
  "C:/path/to/pinescriptV6_MCP/pinescriptMCP/server.mjs",
  "--manual",
  "C:/path/to/pinescriptV6_MCP/pinescriptMCP/manual.json"
]

Codex を再起動し、/mcp に pinescript_mcp とツール群が表示されることを確認してください。

Claude Desktop（JSON）

設定 → Developer → MCP Servers → Add で、次の JSON を追加します。

{
  "mcpServers": {
    "pinescript_mcp": {
      "command": "node",
      "args": [
        "C:/path/to/pinescriptV6_MCP/pinescriptMCP/server.mjs",
        "--manual",
        "C:/path/to/pinescriptV6_MCP/pinescriptMCP/manual.json"
      ]
    }
  }
}

Gemini CLI（JSON）

Gemini CLI の MCP 設定に次を追加します（設定パスは CLI 実装に依存）。

{
  "mcpServers": {
    "pinescript_mcp": {
      "command": "node",
      "args": [
        "C:/path/to/pinescriptV6_MCP/pinescriptMCP/server.mjs",
        "--manual",
        "C:/path/to/pinescriptV6_MCP/pinescriptMCP/manual.json"
      ]
    }
  }
}

使い方（例）

search_docs で {"query":"plot"} を検索 → 候補から get_entry で詳細取得
complete_symbol で {"prefix":"color."} を補完
list_categories で種別件数を把握

注意・ライセンス

本サーバは読み取り専用です。外部への書き込みや外部呼び出しは行いません。
manual.json は本リポジトリ同梱のユーザー生成データです。出典 URL は含まれますが、配布権限はリポジトリ作者の許諾に基づきます。