How do I use cn-financial-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., "@cn-financial-mcp get real-time quote for 600519" 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.

cn-financial-mcp

by ccq1

Overview Schema Related Servers Score Discussions

Python

Remote

cn-financial-mcp

📸 Demo

在 Claude Code 中通过 MCP 工具查询中国西电的盘口走势以及投研分析

简介

cn-financial-mcp 是一个遵循 Model Context Protocol (MCP) 标准的金融数据服务器，专注于cn大陆市场。它让任何支持 MCP 的 AI Agent（如 Claude Code、Cursor、自定义 Agent）都能直接调用 A 股行情、财报、行业、宏观经济等 42 个金融工具，无需 API Key，开箱即用。

底层数据来源于 AKShare，并内置多数据源自动 fallback 机制（东方财富 → 新浪 / 腾讯 / 同花顺），确保在不同网络环境下的可用性。

✨ 功能一览

模块	工具数	说明
公司信息	4	股票搜索、公司概况、主营构成、竞争对手
行情数据	4	实时行情、历史 K 线（日/周/月）、市值、股票列表
财务报表	8	利润表、资产负债表、现金流量表、财务指标、增长率、分部收入
估值分析	4	PE/PB/PS 时序、分红历史、机构持仓、分析师评级
行业板块	5	行业列表、成分股、概念板块、板块资金流、行业估值
市场总览	5	指数概览、个股资金流、北向资金、涨跌停池、龙虎榜
新闻公告	4	个股新闻、财报日历、公司公告、关键词搜索
宏观与衍生	8	GDP/CPI/PMI/M2、汇率、国债收益率、融资融券、高管增减持

合计 42 个工具，覆盖从个股研究到宏观分析的完整链路。

🚀 快速开始

环境要求

Python 3.10+
pip

安装

git clone https://github.com/<your-username>/cn-financial-mcp.git
cd cn-financial-mcp
pip install -e .

验证安装

PYTHONPATH=src python -m cn_financial_mcp --help

usage: __main__.py [-h] [--http] [--port PORT] [--host HOST]

cn-financial-mcp: China Financial Data MCP Server based on AKShare

options:
  -h, --help   show this help message and exit
  --http       Run in HTTP/SSE mode instead of stdio
  --port PORT  Port for HTTP/SSE mode (default: 8000)
  --host HOST  Host for HTTP/SSE mode (default: 127.0.0.1)

📡 部署方式

方式一：stdio 模式（Claude Code / Cursor）

在你的项目根目录 .mcp.json 中添加：

{
  "mcpServers": {
    "cn-financial": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "cn_financial_mcp"],
      "env": {
        "PYTHONPATH": "/absolute/path/to/cn-financial-mcp/src"
      }
    }
  }
}

将 /absolute/path/to/cn-financial-mcp 替换为你的实际路径。配置好后 Agent 会自动拉起 MCP 进程。

方式二：HTTP/SSE 模式（通用 MCP Client）

cd cn-financial-mcp
PYTHONPATH=src python -m cn_financial_mcp --http --host 0.0.0.0 --port 8000

MCP Client 连接 endpoint：

http://<your-ip>:8000/sse

方式三：Docker

cd cn-financial-mcp
docker compose up -d

服务暴露在 http://localhost:8000。

🛠 工具清单

工具	说明
`search_stock`	按名称/代码模糊搜索 A 股
`get_company_info`	获取公司基本信息（行业、市值、股本）
`get_company_profile`	获取主营业务构成及收入占比
`get_competitors`	获取同行业竞争对手列表

工具	说明
`get_realtime_quote`	获取实时行情（最新价、涨跌幅、成交量）
`get_historical_price`	获取历史 K 线（日/周/月，支持前复权/后复权）
`get_market_capitalization`	获取总市值与流通市值
`get_stock_list`	获取 A 股完整列表，支持市值筛选

工具	说明
`get_income_statement`	利润表
`get_balance_sheet`	资产负债表
`get_cash_flow_statement`	现金流量表
`get_financial_line_item`	自定义查询单项科目
`get_financial_indicators`	综合财务指标（ROE、毛利率等）
`get_growth_rates`	营收/利润增长率
`get_per_share_data`	每股指标（EPS、BPS等）
`get_segments_revenue`	分部收入明细

工具	说明
`get_valuation_metrics`	PE/PB/PS 历史时序
`get_dividend_data`	分红派息历史
`get_institutional_holdings`	十大流通股东
`get_analyst_rating`	分析师评级与盈利预测

工具	说明
`get_industry_list`	行业板块列表
`get_industry_stocks`	行业成分股
`get_concept_list`	概念板块列表
`get_sector_fund_flow`	板块资金流向排名
`get_industry_pe`	行业历史行情走势

工具	说明
`get_market_overview`	主要指数实时快照
`get_money_flow`	个股资金流向
`get_north_bound_flow`	北向资金（沪深港通）净流入
`get_limit_up_down`	当日涨停/跌停池
`get_dragon_tiger`	龙虎榜（机构活跃交易）

工具	说明
`get_stock_news`	个股新闻资讯
`get_financial_calendar`	财报披露时间表
`get_company_announcements`	上市公司公告
`search_news`	按关键词搜索新闻

工具	说明
`get_macro_gdp`	GDP 数据
`get_macro_cpi`	CPI 数据
`get_macro_pmi`	PMI 数据
`get_macro_money_supply`	货币供应量（M0/M1/M2）
`get_fx_rate`	汇率查询
`get_bond_yield_curve`	国债收益率曲线
`get_margin_trading`	融资融券数据
`get_insider_trading`	高管增减持

🔄 多数据源 Fallback

为应对部分数据源在云服务器环境下不稳定的问题，内置了自动多源切换：

请求 → 东方财富 (优先，字段最全)
         ↓ 失败
       新浪 / 腾讯 / 同花顺 (备选)
         ↓ 失败
       返回错误

功能	主源	备选源
实时行情	东方财富	新浪 → 新浪单股
历史 K 线	东方财富	腾讯
行业板块	东方财富	同花顺
概念板块	东方财富	同花顺
公司信息	东方财富 emweb	新浪

代码始终优先尝试东方财富。只有当主源连接失败时才自动切换，对调用方完全透明。

🧪 测试

# 安装开发依赖
pip install -e ".[dev]"

# 运行单元测试
pytest tests/ -v

# 仅运行网络无关测试
pytest tests/ -v -m "not network"

📁 项目结构

cn-financial-mcp/
├── src/cn_financial_mcp/
│   ├── __init__.py
│   ├── __main__.py          # CLI 入口
│   ├── server.py             # MCP Server 实例
│   ├── tools/
│   │   ├── company_info.py   # 公司信息 (4 tools)
│   │   ├── price_data.py     # 行情数据 (4 tools)
│   │   ├── financial_stmt.py # 财务报表 (8 tools)
│   │   ├── valuation.py      # 估值分析 (4 tools)
│   │   ├── industry.py       # 行业板块 (5 tools)
│   │   ├── market.py         # 市场总览 (5 tools)
│   │   ├── news_events.py    # 新闻公告 (4 tools)
│   │   └── macro_fx.py       # 宏观衍生 (8 tools)
│   └── utils/
│       ├── cache.py          # TTL 缓存
│       ├── fallback.py       # 多源 fallback
│       ├── formatter.py      # DataFrame → JSON
│       └── symbol.py         # 股票代码工具
├── tests/
├── docs/images/
├── pyproject.toml
├── Dockerfile
├── docker-compose.yml
└── .mcp.json

📄 License

Apache-2.0

🙏 致谢

AKShare — 开源金融数据接口库

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Issues opened vs closed

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.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ccq1/cn-financial-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server