Skip to main content
Glama
groovyjuice

J-Quants Timeseries MCP

by groovyjuice

J-Quants Timeseries MCP

这是一个个人用MCP服务器,从J-Quants API V2获取日本股票的日线数据,并返回ChatGPT可保存到Google Drive"时间序列数据"文件夹的CSV。

主要功能

  • 按股票代码或公司名搜索上市股票

  • 获取 /v2/equities/bars/daily 的所有页面

  • 将调整前/调整后OHLCV及涨停跌停标志转换为CSV

  • 从Render的机密设置中读取目标文件夹ID,并将其包含在工具结果中

  • 当股票有歧义时返回候选项,不靠猜测选择

Related MCP server: Enhanced MCP Stock Query System

环境变量

名称

内容

JQUANTS_API_KEY

J-Quants V2的API密钥。必填。

GOOGLE_DRIVE_FOLDER_ID

目标Drive文件夹的ID。必填。

MCP_ACCESS_TOKEN

MCP URL的机密路径。32个字符以上。必填。

PORT

HTTP监听端口。由Render自动设置。

RENDER_EXTERNAL_HOSTNAME

Render自动设置的公开主机名。

请勿将API密钥、Drive文件夹ID和访问令牌写入源代码、对话或日志中。

本地测试

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. 在Web版ChatGPT的"设置"→"安全与登录"中启用Developer mode。

  2. 在Plugins的添加界面中注册上述MCP URL。

  3. 在对话中从Developer mode选择J-Quants应用和Google Drive。

  4. 请求"获取铠侠的时间序列数据"。

工具会返回CSV、文件名以及从机密设置中读取的目标文件夹ID。ChatGPT会将该CSV上传到指定的Google Drive文件夹。

J-Quants Free的限制

在Free计划中,可获取的股价为过去2年(不含最近12周)的数据。请确认实际返回的 first_datelast_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