Skip to main content
Glama
groovyjuice

J-Quants Timeseries MCP

by groovyjuice

J-Quants Timeseries MCP

Персональный MCP-сервер, который получает дневные бары японских акций через J-Quants API V2 и возвращает CSV, который ChatGPT может сохранить в папку «Временные ряды» в Google Drive.

Основные функции

  • Поиск листинговых бумаг по коду или названию компании

  • Получение всех страниц /v2/equities/bars/daily

  • Преобразование в CSV нескорректированных и скорректированных значений OHLCV и флагов стоп-хай/стоп-лоу

  • Чтение ID папки назначения из секретных настроек Render и включение его в результат инструмента

  • Возврат кандидатов при неоднозначности, а не выбор по догадке

Related MCP server: Enhanced MCP Stock Query System

Переменные окружения

Имя

Описание

JQUANTS_API_KEY

API-ключ J-Quants V2. Обязательно.

GOOGLE_DRIVE_FOLDER_ID

ID папки Drive для сохранения. Обязательно.

MCP_ACCESS_TOKEN

Секретный путь MCP URL. Не менее 32 символов. Обязательно.

PORT

HTTP-порт для прослушивания. Render задаёт автоматически.

RENDER_EXTERNAL_HOSTNAME

Публичное имя хоста, задаваемое Render автоматически.

Не включайте API-ключ, ID папки Drive и токен доступа в исходный код, диалоги или логи.

Локальное тестирование

python -m venv .venv
.venv/bin/pip install -r requirements.txt
PYTHONPATH=. .venv/bin/python -m unittest discover -s tests -v

В Windows PowerShell заменяйте Python виртуального окружения на .venv\\Scripts\\python.exe.

Запуск

JQUANTS_API_KEY=... GOOGLE_DRIVE_FOLDER_ID=... MCP_ACCESS_TOKEN=32文字以上の秘密文字列 python server.py

URL подключения имеет следующий вид:

https://<Renderのホスト名>/mcp/<MCP_ACCESS_TOKEN>

Обращайтесь со всем этим URL как с секретной информацией. Это простое средство защиты для личного использования, а не надёжный механизм, заменяющий OAuth-аутентификацию. В случае утечки заново сгенерируйте MCP_ACCESS_TOKEN.

На стороне ChatGPT

  1. В веб-версии ChatGPT включите Developer mode через «Настройки» → «Безопасность и вход».

  2. Зарегистрируйте указанный выше MCP URL на экране добавления плагинов.

  3. В беседе в режиме Developer mode выберите приложение J-Quants и Google Drive.

  4. Попросите: «Получи временные ряды Kioxia».

Инструмент возвращает содержимое CSV, имя файла и ID папки назначения, полученный из секретных настроек. ChatGPT загружает этот CSV в указанную папку Google Drive.

Ограничения J-Quants Free

В плане Free можно получить котировки за последние 2 года, за исключением последних 12 недель. Проверяйте фактически возвращённые значения first_date и last_date.

Related MCP Connectors

Related MCP Servers

  • -
    license
    Not graded
    quality
    D
    maintenance
    Provides real-time and historical stock market data through the Alpha Vantage API. Enables users to get current stock prices and retrieve historical stock data for any major stock symbol via natural language queries.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI-powered natural language stock market queries with real-time data from Yahoo Finance and CSV fallback. Uses Google Gemini to interpret queries and automatically fetch stock prices, comparisons, and market summaries.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables access to Japanese stock market data via the free J-Quants API, providing tools for company search, daily quotes, and financial statements.
    1
    MIT
  • A
    license
    B
    quality
    C
    maintenance
    Enables AI assistants to access real-time Japanese and global stock market data, including quotes, charts, technical analysis, and market screening.
    7
    9 npm
    MIT