MCP-蜡烛图数据
以分钟为单位的OHLCV蜡烛图和辅助指标值通过MCP（模型上下文协议）接口 这是一个提供的HTTP服务器。在单击式工作流中，包括股票代码、分钟线间隔、辅助指标 输入设置后，可以实时接收价格/指标数据的流式传输。
事先准备
- Python 3.11 或更高版本
- 包管理工具 紫外线
- 服务器运行时Yahoo Finance API(
yfinance可访问的网络 - MCP兼容客户端（OpenAI Desktop、VSCode MCP桥接器等）
快速启动
# 가상환경 생성 및 의존성 설치
uv sync
# MCP HTTP 서버 실행 (기본: 0.0.0.0:8765, 스트리밍 활성화)
uv run mcp-candledata可选环境变量：
MCP_CANDLEDATA_HOST– 绑定地址（默认值0.0.0.0）MCP_CANDLEDATA_PORT– 端口（默认值8765)MCP_CANDLEDATA_STREAMING–0若设置为，则禁用流媒体
工具合同（Tool Contract）
get_candle_data 接收以下JSON输入：
{
"ticker": "TSLA", // alias: "symbol"
"provider": "yahoo", // alias: "source", "vendor", "exchange" (기본값 auto)
"interval": "5m", // alias: "interval_minutes"
"limit": 120,
"indicators": [
{ "name": "sma", "window": 20 },
{ "name": "rsi" }
]
}symbol/interval_minutes 字段名称和整数分单位输入也原样支持。
如果想查询虚拟货币（Upbit）行情 provider （这个韩语字符“를”在单独出现时，通常不直接翻译为中文，而是作为助词或语素的一部分，在句子中起到特定的语法作用。如果尝试将其放在一个可能的语境中翻译，比如“을/를”作为宾格助词，可以理解为“它/他/她/它们/这/那（作为宾语）”，但具体翻译需结合上下文。在没有具体上下文的情况下，直接翻译“를”为中文并不准确，因此这里保持其作为韩语助词的形式说明。） "upbit" 或指定为 股票代码（或“行情板”） KRW-BTC， USDT-ETH 请以Upbit市场代码格式传递。 支持的时间间隔符合Upbit REST API规范（分钟线：1/3/5/10/15/30/60/240，日线：1d）。 示例：
{
"symbol": "KRW-BTC",
"provider": "upbit",
"interval": 1,
"limit": 100
}请求字段详情
symbol|ticker要查询的项目代码。Upbit格式(KRW-BTC)的话就会自动provider加（注：此为韩语字母“가”的直接音译，若作为汉字词或特定语境下的翻译，可能需要根据上下文进行具体解释或调整，但在此仅提供直接音译）upbit被设置为。provider："yahoo"或者"upbit". 基于未指定的时钟符号进行推断。interval_minutes|interval以分钟为单位的整数或"5m"，"2h"，"1d"相同的字符串。Upbit只允许符合规范的值。limit最近蜡烛数量（基本120，最少5，最多500）。start如果指定它，优先级就会降低。indicators：{ "name": "sma", "window": 20 }形态的排列。window如果省略不写，则SMA/EMA为20，RSI为14，MACD为（12，26，9），布林带为20/2标准差计算。start/endUTC时间戳字符串或ISO8601。指定时，仅返回该范围内的蜡烛图，end如果省略它，则使用当前时间。
回答结构
回答如下 CandleDataResponse 这是JSON结构。
{
"symbol": "TSLA",
"interval_minutes": 5,
"candles": [
{
"timestamp": "2024-05-02T09:35:00Z",
"open": 175.21,
"high": 175.44,
"low": 174.91,
"close": 175.10,
"volume": 1023400.0
}
],
"indicators": {
"sma": [
{ "timestamp": "2024-05-02T09:35:00Z", "values": { "value": null } }
],
"macd": [
{
"timestamp": "2024-05-02T09:35:00Z",
"values": { "macd": null, "signal": null, "histogram": null }
}
]
}
}像初期阶段那样计算不成立的点是 null 将被填充。未请求的指标键不会包含在响应中。
支持的辅助指标名称： sma， ema， rsi， macd， bbands
响应中包含按所请求的分钟数对齐的最近K线，以及各辅助指标的时间序列数据。
隧道技术/远程访问
ngrok 使用如等隧道工具，可以暴露本地HTTP端点。
uv run mcp-candledata &
ngrok http http://127.0.0.1:8765将收到的公共URL输入到MCP客户端设置中后，外部也可以同样访问。