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 を追加

---

インストール / 実行

0. クローン導入（推奨）

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

1. 依存インストール

npm i

2. 起動（手動起動の例）

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 は含まれますが、配布権限はリポジトリ作者の許諾に基づきます。