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