AKShare One MCP Server

By zwldarren GitHub

An MCP server based on akshare-one, providing interfaces for China stock market data.

mcp stock-data

Overview

What is AKShare One MCP Server?

AKShare One MCP Server is a server that provides interfaces for accessing China stock market data, built on the akshare-one framework. It allows users to retrieve various financial information including historical stock data, real-time data, news data, and financial statements.

How to use AKShare One MCP Server?

To use the AKShare One MCP Server, clone the repository from GitHub, install the necessary dependencies, and run the server using the provided commands. Users can then access the data through the defined API endpoints.

Key features of AKShare One MCP Server?

Access to historical stock data with customizable parameters
Real-time stock data retrieval
Stock-related news data access
Company financial statements including balance sheets, income statements, and cash flow statements
Insider trading data retrieval

Use cases of AKShare One MCP Server?

Analyzing historical stock performance for investment decisions.
Monitoring real-time stock prices for trading.
Researching company financial health through balance sheets and income statements.
Keeping up with stock market news and trends.

FAQ from AKShare One MCP Server?

What data sources does the server support?

The server supports data from Eastmoney and Sina.

Is there a limit to the number of requests?

The server does not impose strict limits, but users should be mindful of the data source's usage policies.

Can I customize the data retrieval parameters?

Yes! Users can customize parameters such as date range, data source, and adjustment types.

Content

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', 'sina') (default: 'eastmoney')

`get_realtime_data`

Get real-time stock data Input parameters:

symbol (string, optional): Stock code
source (string, optional): Data source (default: 'eastmoney')

`get_news_data`

Get stock-related news data Input parameters:

symbol (string): Stock code
source (string, optional): Data source (default: 'eastmoney')

`get_balance_sheet`

Get company balance sheet data Input parameters:

symbol (string): Stock code
source (string, optional): Data source (default: 'sina')

`get_income_statement`

Get company income statement data Input parameters:

symbol (string): Stock code
source (string, optional): Data source (default: 'sina')

`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
source (string, optional): Data source (default: 'xueqiu')

Usage Instructions

Running the server

Clone this repository:

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

Install uv (https://docs.astral.sh/uv/getting-started/installation/)
Install dependencies:
```
uv sync
```
Run the server:
```
uv run main.py
```

Connect to Claude Desktop

Add the following configuration to the MCP server configuration file:

"mcpServers": {
    "akshare-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/path/to/akshare-one-mcp",
            "run",
            "main.py"
        ]
    }
}