What is Akshare One Mcp

akshare-one-mcp is an MCP server based on akshare-one, providing interfaces for accessing various types of China stock market data.

Use cases

Use cases include analyzing historical stock performance, monitoring real-time stock prices, gathering news for specific stocks, and evaluating company financial health through balance sheets and income statements.

How to use

To use akshare-one-mcp, clone the repository and run the server. You can then access various endpoints to retrieve historical stock data, real-time data, news data, and financial statements by providing the appropriate parameters.

Key features

Key features include retrieving historical stock data, real-time stock data, stock-related news, company balance sheets, income statements, cash flow statements, and insider trading data.

Where to use

akshare-one-mcp can be used in financial analysis, stock market research, investment decision-making, and by developers needing stock market data for applications.

AKShare One MCP Server

An MCP server based on akshare-one, providing interfaces for China stock market data. It offers a set of tools for retrieving financial information including historical stock data, real-time data, news data, financial statements, etc.

Tools

get_hist_data

Get historical stock data
Input parameters:

• symbol (string): Stock code
• interval (string): Time interval (‘minute’,‘hour’,‘day’,‘week’,‘month’,‘year’)
• interval_multiplier (number, optional): Interval multiplier (default: 1)
• start_date (string, optional): Start date in YYYY-MM-DD format (default: ‘1970-01-01’)
• end_date (string, optional): End date in YYYY-MM-DD format (default: ‘2030-12-31’)
• adjust (string, optional): Adjustment type (‘none’, ‘qfq’, ‘hfq’) (default: ‘none’)
• source (string, optional): Data source (‘eastmoney’, ‘eastmoney_direct’, ‘sina’) (default: ‘eastmoney’)

get_realtime_data

Get real-time stock data
Input parameters:

• symbol (string, optional): Stock code
• source (string, optional): Data source (‘xueqiu’, ‘eastmoney_direct’) (default: ‘xueqiu’)

get_news_data

Get stock-related news data
Input parameters:

• symbol (string): Stock code
• recent_n (number, optional): Number of most recent records to return (optional)

get_balance_sheet

Get company balance sheet data
Input parameters:

• symbol (string): Stock code
• recent_n (number, optional): Number of most recent records to return (optional)

get_income_statement

Get company income statement data
Input parameters:

• symbol (string): Stock code
• recent_n (number, optional): Number of most recent records to return (optional)

get_cash_flow

Get company cash flow statement data
Input parameters:

• symbol (string): Stock code
• source (string, optional): Data source (default: ‘sina’)

get_inner_trade_data

Get company insider trading data
Input parameters:

• symbol (string, optional): Stock code

get_current_time

Get current time with ISO format, timestamp, and the last trading day

Usage Instructions

Installing via Smithery

To install akshare-one-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude

Installing via uv

Install directly from PyPI using uv:

uv pip install akshare-one-mcp

Add the following configuration:

Installing via local source code

1. Clone this repository:

   git clone https://github.com/zwldarren/akshare-one-mcp.git
   cd akshare-one-mcp
   

2. Install uv if you haven’t already.

3. Install dependencies:

   uv sync
   

4. Add the following configuration: