Skip to main content

Akshare MCP Server - A Model Context Protocol server for accessing Chinese stock market data via AKShare

Project description

AKShare MCP Server

A Model Context Protocol (MCP) server for accessing Chinese stock market data via AKShare.

Features

  • 🏢 Market Overview: Shanghai and Shenzhen Exchange market statistics data
  • 🏢 Stock Information: East Money stock information, Xueqiu company profiles
  • 🏭 Industry Sectors: Industry sector data, real-time quotes, constituent stock information
  • 🔥 Stock Hotness: A-share popularity rankings, Xueqiu trading rankings
  • 📈 Real-time Quotes: Shanghai-Shenzhen-Beijing A-share real-time quotes, stock prices, limit-up stock pools
  • 📊 Historical Data: A-share historical K-line data, Tencent Securities historical data, intraday quotes
  • 💰 Fundamental Analysis: Financial indicators, profit forecasts, information disclosure announcements
  • 📈 Fund Flow: Dragon and Tiger list details, individual stock fund flow, institutional participation
  • 📰 News & Updates: Global financial news, Futu Niuniu updates
  • 📊 Peer Comparison: Valuation comparison, growth comparison
  • 🔧 Utility Tools: Stock code lookup, trading calendar, insider trading data, stock research reports

Installation

pip install akshare-tools

Usage

Using MCP Inspector

MCP Inspector is a command-line tool for testing and debugging MCP servers:

npx @modelcontextprotocol/inspector uvx akshare-tools

Using with MCP Client

Configure in MCP-compatible applications (like Claude Desktop):

{
    "mcpServers": {
      "akshare-mcp": {
        "command": "uvx",
        "args": [
          "akshare-tools"
        ]
      }
    }
}

Available Tools

📊 Stock Market Overview

  • get_stock_sse_summary: Shanghai Stock Exchange stock data summary
  • get_stock_szse_summary: Shenzhen Stock Exchange market summary - security category statistics

🏢 Stock Information

  • get_stock_individual_info_em: East Money - Individual Stock - Stock Information
  • get_stock_individual_basic_info_xq: Xueqiu - Individual Stock - Company Profile - Company Introduction

🏭 Industry Sectors

  • get_stock_board_industry_name_em: East Money - Shanghai-Shenzhen-Beijing Sectors - Industry Sector Data
  • get_stock_board_industry_spot_em: East Money - Shanghai-Shenzhen Sectors - Industry Sector - Real-time Quote Data
  • get_stock_board_industry_cons_em: East Money - Shanghai-Shenzhen Sectors - Industry Sector - Sector Constituent Stock Data

🔥 Stock Hotness

  • get_stock_hot_rank_em: East Money - Stock Hotness - Popularity Ranking Data
  • get_stock_hot_deal_xq: Xueqiu - Shanghai-Shenzhen Stock Market - Hotness Ranking - Trading Ranking Data

📈 Real-time Quotes

  • get_stock_zh_a_spot_em: Shanghai-Shenzhen-Beijing A-share Real-time Quote Data
  • get_stock_info_xueqiu: Xueqiu Individual Stock Real-time Market Data Information
  • get_stock_zt_pool_em: East Money - Limit-up Stock Pool Data

📊 Historical Data

  • get_stock_a_hist: A-share Historical K-line Data
  • get_stock_zh_a_hist_tx: Tencent Securities - Daily Frequency - Stock Historical Data
  • get_stock_zh_a_hist_min_em: East Money - Shanghai-Shenzhen-Beijing A-shares - Daily Intraday Quote Data

💰 Fundamental Analysis

  • get_stock_financial_analysis_indicator: Sina Finance - Financial Analysis - Financial Indicator Data
  • get_stock_profit_forecast_em: East Money - Data Center - Research Reports - Profit Forecast
  • get_stock_zh_a_disclosure_report_cninfo: CNINFO - Information Disclosure Announcements

📈 Fund Flow

  • get_stock_lhb_detail_em: East Money - Data Center - Dragon and Tiger List - Dragon and Tiger List Details
  • get_stock_individual_fund_flow: East Money - Data Center - Individual Stock Fund Flow
  • get_stock_comment_detail_zlkp_jgcyd_em: East Money - Data Center - Featured Data - Thousands of Comments - Main Control - Institutional Participation Data

📰 News & Updates

  • get_stock_info_global_em: East Money - Global Financial News
  • get_stock_info_global_futu: Futu Niuniu - Updates

📊 Peer Comparison

  • get_stock_zh_valuation_comparison_em: East Money - Quote Center - Peer Comparison - Valuation Comparison Data
  • get_stock_zh_growth_comparison_em: East Money - Quote Center - Peer Comparison - Growth Comparison Data

🔧 Utility Tools

  • get_stock_info_a_code_name: Shanghai-Shenzhen-Beijing A-share Stock Codes and Stock Short Names Data (supports fuzzy matching by company name)
  • get_tool_trade_date_hist_sina: Sina Finance - Stock Trading Calendar Data
  • get_stock_inner_trade_xq: Xueqiu - Quote Center - Shanghai-Shenzhen Stock Market - Insider Trading Data
  • get_stock_research_report_em: East Money - Data Center - Research Reports - Individual Stock Research Report Data

Development

Install Development Dependencies

pip install -e ".[dev]"

Run Tests

pytest

Code Formatting

black src/
ruff check src/

License

MIT License - see LICENSE file for details

Contributing

Issues and Pull Requests are welcome!

Related Links


Language: English | 中文

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

akshare_tools-0.1.7.tar.gz (408.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

akshare_tools-0.1.7-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

Details for the file akshare_tools-0.1.7.tar.gz.

File metadata

  • Download URL: akshare_tools-0.1.7.tar.gz
  • Upload date:
  • Size: 408.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for akshare_tools-0.1.7.tar.gz
Algorithm Hash digest
SHA256 99c4586a1cc5ecb0a3bb6fd0a6f6861cd054c88f3ede5d22007f32a7aaaf181a
MD5 6a66ea817ffab481db9130615f845224
BLAKE2b-256 f74c913aa5caec833e3eab56d10df7ae9348ad2c60177e80be3b284a75879bb7

See more details on using hashes here.

File details

Details for the file akshare_tools-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: akshare_tools-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 10.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for akshare_tools-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 4ae7090c917e07b1beca3b049ebbe13f39f45bcb84e057dc9d531970392de246
MD5 7d8182cbf1e0e147076ece3d37d43c54
BLAKE2b-256 7f589dc1b8979ef302c4cc156d90d91ca2a7525685aada707a07d4680446075a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page