stockmatrix-mcp

stockmatrix-mcp

StockMatrix（https://stockmatrix.co.kr）的官方 MCP 服务。

用自然对话向 AI 询问韩国股市主题。跟踪 200 多个 KOSPI/KOSDAQ 投资主题，获取每日涨跌情况，查询股票所属主题，比较不同主题并查看预测——全部通过 Claude、Cursor 或任何兼容 MCP 的 AI Agent 完成。

由 TLI（主题生命周期指数） 提供支持——这是一种经贝叶斯优化的评分算法，将搜索热度、新闻动能、市场波动性和股票活跃度综合为 0-100 分，并对生命周期阶段进行分类。

11 个工具 + 4 个一键工作流提示词 + 实时资源。 试试 market_briefing 斜杠命令，即可即时查看韩国市场概览。

快速开始

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "stockmatrix": {
      "command": "npx",
      "args": ["-y", "stockmatrix-mcp"]
    }
  }
}

Cursor / Windsurf

添加到 .cursor/mcp.json 或 .windsurf/mcp.json：

{
  "mcpServers": {
    "stockmatrix": {
      "command": "npx",
      "args": ["-y", "stockmatrix-mcp"]
    }
  }
}

VS Code / Claude Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "stockmatrix": {
      "command": "npx",
      "args": ["-y", "stockmatrix-mcp"]
    }
  }
}

试着这样提问

完成设置后，直接用自然语言提问：

提示词	效果
"요즘 뜨는 테마 TOP 5"	按 TLI 分数排名的前 5 个主题
"오늘 한국 테마 시장 요약해줘"	经 AI 优化的市场概览
"어제 대비 가장 많이 오른 테마는?"	每日分数变动和阶段转换
"AI 관련 테마 찾아줘"	搜索 AI 相关主题
"반도체 vs 2차전지 비교해줘"	并排比较不同主题
"앞으로 오를 테마 알려줘"	基于类比证据的上涨预测
"삼성전자가 속한 테마"	查询股票所属主题（自动识别 6 位代码）
"방산 테마 상세 정보"	分数明细、股票、新闻和比较
"반도체 테마 최근 한달 추세"	30 天分数历史
"TLI 점수는 어떻게 계산돼?"	算法方法说明（提示：使用 section=scoring 可节省 token）
"What are the hottest stock themes in Korea?"	也支持英语

可用工具

get_theme_ranking

按生命周期阶段获取主题排名，并设置数量限制和排序选项。

参数	类型	必填	描述
stage	string	否	emerging / growth / peak / decline / reigniting
limit	number	否	每个阶段的结果数（1-50，默认值：10）
sort	string	否	score / change7d / newsCount7d（默认值：score）

get_market_summary

获取经 AI 优化的市场概览及热门主题（包含可用于后续调用的 themeId）。

get_theme_changes

获取每日或每周的分数变动、阶段转换和新兴主题。

参数	类型	必填	描述
period	string	否	1d（默认值）/ 7d

compare_themes

并排比较 2-5 个主题的分数、股票、迷你趋势图和相似度。

参数	类型	必填	描述
theme_ids	string[]	是	由 2-5 个主题 UUID 组成的数组

get_predictions

根据历史类比匹配，获取预计将上涨、达到峰值或降温的主题。

参数	类型	必填	描述
phase	string	否	rising / hot / cooling（默认值：全部）

search_themes

按关键词、股票名称或股票代码搜索主题。

参数	类型	必填	描述
query	string	是	例如："AI"、"반도체"、"삼성전자"、"005930"

search_stocks

按公司名称或 6 位代码搜索股票，并预览相关主题。输入 6 位代码时会自动查询股票所属主题。

参数	类型	必填	描述
query	string	是	例如："삼성전자"、"SK하이닉스"、"005930"

get_stock_themes

反向查询 — 某只股票所属的所有主题，按主题得分排序，并显示每个主题的生命周期阶段及其与该股票的相关性。回答“我的股票是否属于热门主题？”

参数	类型	必填	描述
symbol	string	是	6 位韩国股票代码，例如 "005930"（Samsung）、"000660"（SK Hynix）

get_theme_detail

获取详细分析：得分细分（4 个组成部分）、阶段、预测、股票、新闻和比较。

参数	类型	必填	描述
theme_id	string (UUID)	是	来自排名或搜索结果的主题 UUID

get_theme_history

获取 30 天得分历史记录，用于趋势分析。

参数	类型	必填	描述
theme_id	string (UUID)	是	主题 UUID

get_methodology

获取 TLI 算法文档 — 评分、阶段、稳定化、比较、预测、数据来源等。

参数	类型	必填	描述
section	string	否	scoring / stages / comparison / prediction / all（默认：all）

提示：使用 section=scoring 仅获取评分算法，节省上下文令牌。

工作流提示词

一键斜杠命令（适用于 Claude Desktop、Cursor 和其他 MCP 客户端），可为你运行完整的多工具分析 — 快速获取实际价值的最佳方式：

提示词	参数	功能
market_briefing	—	今日韩国市场主题简报：市场情绪、热门主题、异动主题、要点
theme_deep_dive	theme	对单个主题进行完整生命周期分析：得分、30 天趋势、股票、新闻、展望
find_investment_themes	interest	发现符合某项兴趣的主题，并按动能和阶段排序
stock_theme_check	stock	检查某只股票（名称或代码）是否属于任何热门或上升主题

资源

可附加的只读上下文（无需调用工具）：

URI	描述
stockmatrix://methodology	TLI 得分和生命周期阶段的计算方式 — 权重和阈值
stockmatrix://rankings	今日主题得分排名的实时快照，按阶段分组

评分算法

TLI 得分（0-100）是通过贝叶斯优化确定权重后，对 4 个组成部分加权求和得出的：

组成部分	权重	来源
搜索热度	30.4%	Naver DataLab
新闻动能	36.6%	Naver News
波动性	10.4%	热度时间序列
股票活跃度	22.6%	Naver Finance

得分通过 谨慎衰减（3 信号多数投票）、布林带限制（限制每日变化）和 自适应年龄 EMA（较新的主题反应更快）进行稳定化处理。

生命周期阶段

Dormant -> Emerging -> Growth -> Peak -> Decline -> Dormant
                                          |
                                     Reigniting

阶段转换要求连续 2 天出现相同的候选阶段（滞后机制），并遵循马尔可夫转移约束。

数据覆盖范围

• 200+ 个主题，覆盖 KOSPI 和 KOSDAQ
• 每日更新 — 得分、新闻、股票映射
• 股票 ↔ 主题查询 — 按公司名称、6 位代码查询，或反向查询（股票 → 所有所属主题）
• AI 市场摘要，用于首次调用时快速了解概况
• 预测，并匹配历史类似案例
• 工作流提示词 — 一键运行多工具分析
• 来源：Naver DataLab、Naver Finance、Naver News

配置

变量	默认值	描述
STOCKMATRIX_API_URL	https://stockmatrix.co.kr	覆盖 API 基础 URL

许可证

MIT

链接

• 网站
• 开发者指南
• llms.txt