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.6.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.6-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: akshare_tools-0.1.6.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.6.tar.gz
Algorithm Hash digest
SHA256 b4e441163c9629deffe1a9e47cfc57837712f4d47de446f98e9cc0eb744a0eda
MD5 b6cccd4b851a6f39848ac8aa2fcaa7c1
BLAKE2b-256 da3e8c09cc87833f68abd926fa3e3750fa571a62cde2e39b5c5727e87d87bf2c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: akshare_tools-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 10.1 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 6f69c6abcda0a71085346a222983f8024f9ecc10e7737431d743f42198bdb430
MD5 5ec5f3de459bbacd8d7376ebe4b233ac
BLAKE2b-256 f1660a332d4e57e3c3e43d35820bdd09bc163dbf75a35291a6db9173f8bac5c9

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