sfc-data-mcp
SFC Data Comprehensive MCP Server
南财财经 (SFC) 金融数据终端 MCP 服务,将 SFC 金融数据 API 封装为 MCP 工具,提供 A 股全面的数据查询能力。
功能模块
模块 | 工具数量 | 功能说明 |
📊 实时行情 | 3 | 股票报价、分时数据、K线数据 |
🏆 排行榜 | 4 | 个股/ETF/基金/板块涨幅榜、跌幅榜 |
🚀 涨停统计 | 4 | 连板情况、涨停列表、大涨主题、大涨股票 |
📰 资讯快讯 | 5 | 最新文章、7*24快讯、股票资讯、公司公告、搜索资讯 |
🏷️ 主题概念 | 7 | 主题列表、详情、成分股、产业链、主题基金、搜索、推荐 |
🌍 宏观经济 | 1 | GDP、CPI、PPI、PMI 等宏观数据 |
💰 财务数据 | 4 | 资产负债表、利润表、现金流量表、财务指标 |
💸 资金流向 | 1 | 个股主力资金、散户资金流向 |
🔍 深度分析 | 1 | 个股综合分析(行情+财务+资金+资讯) |
🖼️ 行情图片 | 1 | 市场指数图、涨跌分布、板块排行、分时图、K线图 |
📑 研报查询 | 1 | 券商研究报告 |
⭐ 自选股 | 1 | 自选股分组及行情 |
共计 32 个 MCP 工具
快速开始
1. 安装依赖
pip install -r requirements.txt2. 配置 Token
复制 .env.example 为 .env,填入你的 SFC Token:
cp .env.example .env或者设置环境变量:
# Linux/macOS
export SFC_TOKEN=your-token-here
# Windows PowerShell
$env:SFC_TOKEN = "your-token-here"3. 运行服务
python server.pyMCP 服务配置
在 MCP 客户端配置文件中添加:
{
"mcpServers": {
"sfc-data": {
"command": "python",
"args": ["server.py"],
"cwd": "/path/to/sfc-data-mcp",
"env": {
"SFC_TOKEN": "your-token-here"
}
}
}
}工具列表
1. 实时行情
工具名 | 说明 | 参数 |
| 获取A股股票实时行情 |
|
| 获取股票分时数据 |
|
| 获取股票K线数据 |
|
2. 排行榜
工具名 | 说明 | 参数 |
| 获取个股排行榜 |
|
| 获取ETF排行榜 |
|
| 获取基金排行榜 |
|
| 获取板块排行榜 |
|
3. 涨停统计
工具名 | 说明 | 参数 |
| 获取涨停统计(连板情况) |
|
| 获取涨停股票列表 |
|
| 获取大涨主题库 |
|
| 获取主题大涨股票 |
|
4. 资讯快讯
工具名 | 说明 | 参数 |
| 获取最新文章 |
|
| 获取7*24快讯 |
|
| 获取股票资讯 |
|
| 获取公司公告 |
|
| 搜索资讯 |
|
5. 主题概念
工具名 | 说明 | 参数 |
| 获取主题列表 |
|
| 获取主题详情 |
|
| 获取主题成分股 |
|
| 获取主题产业链 |
|
| 获取主题基金 |
|
| 搜索主题 |
|
| 获取推荐主题 |
|
6. 宏观经济
工具名 | 说明 | 参数 |
| 获取宏观经济数据 |
|
7. 财务数据
工具名 | 说明 | 参数 |
| 获取资产负债表 |
|
| 获取利润表 |
|
| 获取现金流量表 |
|
| 获取主要财务指标 |
|
8. 资金流向
工具名 | 说明 | 参数 |
| 获取个股资金流向 |
|
9. 深度分析
工具名 | 说明 | 参数 |
| 获取个股综合分析 |
|
10. 行情图片
工具名 | 说明 | 参数 |
| 生成行情图片 |
|
widget_type 说明:
1: 市场指数图
2: 市场涨跌分布图
3: 板块涨跌幅榜图
4: 股票分时图
5: K线图
6: 当日涨幅榜图
7: 全球指数图
11. 研报查询
工具名 | 说明 | 参数 |
| 获取研究报告 |
|
12. 自选股
工具名 | 说明 | 参数 |
| 获取自选股分组 | 无 |
使用示例
查询实时行情
{
"name": "get_realtime_quote",
"arguments": {
"code": "300724"
}
}查询涨停统计
{
"name": "get_limit_up_count",
"arguments": {}
}查询大涨主题
{
"name": "get_limit_surge_themes",
"arguments": {}
}查询主题成分股
{
"name": "get_theme_stocks",
"arguments": {
"theme_id": "11060009"
}
}查询财务指标
{
"name": "get_financial_indicators",
"arguments": {
"code": "300724"
}
}生成K线图
{
"name": "generate_chart",
"arguments": {
"widget_type": 5,
"code": "300724"
}
}Docker 部署
# 构建镜像
docker build -t sfc-data-mcp .
# 运行容器
docker run -d \
--name sfc-data-mcp \
-e SFC_TOKEN=your-token-here \
sfc-data-mcp获取 API Token
注册账号并登录
在个人中心获取 API Token
将 Token 配置到环境变量或
.env文件
技术栈
Python 3.11+
MCP (Model Context Protocol)
httpx (HTTP 客户端)
python-dotenv (环境变量管理)
数据来源
所有数据来源于南方财经 (SFC) 金融数据终端。
南方财经(南方财经全媒体集团)是经中央批准的全国首家全媒体集团,由南方报业传媒集团和广东广播电视台联合发起成立。
License
MIT