akshare-one MCP Server

Use This MCP server To

Retrieve historical stock prices for Chinese equities Access real-time Chinese stock market data streams Fetch financial news related to Chinese companies Obtain detailed financial statements for listed firms Integrate Chinese market data into AI trading assistants Generate financial reports using up-to-date market data Analyze stock trends with interval-based historical data Build investment dashboards with live market updates

README

AKShare One MCP Server

English | 中文

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

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:

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

Installing via local source code

Clone this repository:

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

Install uv if you haven't already.
Install dependencies:
```
uv sync
```

Add the following configuration:

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

akshare-one-mcp FAQ

How do I query historical stock data using akshare-one-mcp?

Use the 'get_hist_data' tool with parameters like symbol and interval to retrieve historical prices.

Can akshare-one-mcp provide real-time stock market updates?

Yes, it supports fetching real-time data for Chinese stocks through its API endpoints.

What types of financial data are accessible via this MCP server?

It provides historical data, real-time quotes, financial news, and company financial statements.

Is authentication required to use akshare-one-mcp?

Authentication requirements depend on the deployment; typically, API keys or tokens may be needed for access control.

How frequently is the financial data updated?

Real-time data is updated continuously during market hours; historical and financial statements are updated as released.

Can I customize the data intervals for historical stock data?

Yes, intervals like minute, hour, day, week, month, and year are supported with optional multipliers.

Does akshare-one-mcp support batch queries for multiple stocks?

Batch querying depends on the implementation; typically, multiple requests can be made programmatically.

What programming languages can interact with this MCP server?

Any language that can make HTTP requests can interact with the server, including Python, JavaScript, and others.

akshare-one-mcp

Use This MCP server To

README