How do I use sfc-data-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@sfc-data-mcp get real-time quote for stock 300724" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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.txt

2. 配置 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.py

MCP 服务配置

在 MCP 客户端配置文件中添加：

{
  "mcpServers": {
    "sfc-data": {
      "command": "python",
      "args": ["server.py"],
      "cwd": "/path/to/sfc-data-mcp",
      "env": {
        "SFC_TOKEN": "your-token-here"
      }
    }
  }
}

工具列表

1. 实时行情

工具名	说明	参数
`get_realtime_quote`	获取A股股票实时行情	`code` (股票代码)
`get_minute_data`	获取股票分时数据	`code`, `date` (可选)
`get_kline_data`	获取股票K线数据	`code`, `period` (可选), `count` (可选)

2. 排行榜

工具名	说明	参数
`get_stock_ranking`	获取个股排行榜	`rank_type` (gain/loss/volume/amount), `count`
`get_etf_ranking`	获取ETF排行榜	`rank_type`, `count`
`get_fund_ranking`	获取基金排行榜	`rank_type`, `count`
`get_sector_ranking`	获取板块排行榜	`sector_type` (industry/concept)

3. 涨停统计

工具名	说明	参数
`get_limit_up_count`	获取涨停统计（连板情况）	`date` (可选)
`get_limit_up_list`	获取涨停股票列表	`date`, `flag`, `page`, `size`
`get_limit_surge_themes`	获取大涨主题库	`date` (可选)
`get_limit_surge_stocks`	获取主题大涨股票	`theme_id`, `date`, `is_limit_up`

4. 资讯快讯

工具名	说明	参数
`get_recent_news`	获取最新文章	`count`
`get_flash_news`	获取7*24快讯	`keyword` (可选), `count`
`get_stock_news`	获取股票资讯	`code`, `count`
`get_company_notice`	获取公司公告	`code`, `count`
`search_news`	搜索资讯	`keyword`, `count`

5. 主题概念

工具名	说明	参数
`get_theme_list`	获取主题列表	`page`, `size`
`get_theme_detail`	获取主题详情	`theme_id` 或 `theme_name`
`get_theme_stocks`	获取主题成分股	`theme_id`, `page`, `size`
`get_theme_industry_chain`	获取主题产业链	`theme_id`
`get_theme_funds`	获取主题基金	`theme_id`, `page`, `size`
`search_theme`	搜索主题	`keyword`, `size`
`get_recommended_themes`	获取推荐主题	`theme_type` (2/3/4), `size`

6. 宏观经济

工具名	说明	参数
`get_macro_data`	获取宏观经济数据	`indicator_code` (可选), `category` (可选)

7. 财务数据

工具名	说明	参数
`get_balance_sheet`	获取资产负债表	`code`, `count`
`get_income_statement`	获取利润表	`code`, `count`
`get_cash_flow`	获取现金流量表	`code`, `count`
`get_financial_indicators`	获取主要财务指标	`code`

8. 资金流向

工具名	说明	参数
`get_capital_flow`	获取个股资金流向	`code`, `count`

9. 深度分析

工具名	说明	参数
`get_stock_analysis`	获取个股综合分析	`code`

10. 行情图片

工具名	说明	参数
`generate_chart`	生成行情图片	`widget_type`, `code`, `chart_type`, `period`

widget_type 说明：

1: 市场指数图
2: 市场涨跌分布图
3: 板块涨跌幅榜图
4: 股票分时图
5: K线图
6: 当日涨幅榜图
7: 全球指数图

11. 研报查询

工具名	说明	参数
`get_research_reports`	获取研究报告	`keyword` (可选), `count`

12. 自选股

工具名	说明	参数
`get_watchlist_groups`	获取自选股分组	无

使用示例

查询实时行情

{
  "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

访问 https://www.sfconnect.cn
注册账号并登录
在个人中心获取 API Token
将 Token 配置到环境变量或 .env 文件

技术栈

Python 3.11+
MCP (Model Context Protocol)
httpx (HTTP 客户端)
python-dotenv (环境变量管理)

数据来源

所有数据来源于南方财经 (SFC) 金融数据终端。

南方财经（南方财经全媒体集团）是经中央批准的全国首家全媒体集团，由南方报业传媒集团和广东广播电视台联合发起成立。

License

MIT

This server cannot be installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

sfc-data-mcp