https://github.com/zwldarren/akshare-one-mcp
MCP server that provides access to Chinese stock market data using akshare-one
https://github.com/zwldarren/akshare-one-mcp
akshare mcp mcp-server stock-data
Last synced: 3 months ago
JSON representation
MCP server that provides access to Chinese stock market data using akshare-one
- Host: GitHub
- URL: https://github.com/zwldarren/akshare-one-mcp
- Owner: zwldarren
- License: mit
- Created: 2025-04-08T06:32:41.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-06-17T09:05:53.000Z (4 months ago)
- Last Synced: 2025-06-17T09:16:11.469Z (4 months ago)
- Topics: akshare, mcp, mcp-server, stock-data
- Language: Python
- Homepage:
- Size: 314 KB
- Stars: 16
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **akshare-one-mcp** - MCP server that provides access to Chinese stock market data using akshare-one `python` `akshare` `mcp` `mcp-server` `stock-data` `pip install git+https://github.com/zwldarren/akshare-one-mcp` (AI/ML)
- awesome-mcp-servers - **akshare-one-mcp** - MCP server that provides access to Chinese stock market data using akshare-one `python` `akshare` `mcp` `mcp-server` `stock-data` `pip install git+https://github.com/zwldarren/akshare-one-mcp` (AI/ML)
- mcp-index - AKShare One MCP Server - Access comprehensive Chinese stock market data including historical prices, real-time updates, news, and financial statements. Retrieve detailed financial information for stocks with customizable parameters to support analysis and decision-making. (APIs and HTTP Requests)
README
# AKShare One MCP Server
[](https://smithery.ai/server/@zwldarren/akshare-one-mcp)
An MCP server based on [akshare-one](https://github.com/zwldarren/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](https://smithery.ai/server/@zwldarren/akshare-one-mcp):
```bash
npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude
```
### Installing via `uv`
Install directly from PyPI using uv:
```bash
uv pip install akshare-one-mcp
```
Add the following configuration:
```json
"mcpServers": {
"akshare-one-mcp": {
"command": "uvx",
"args": ["akshare-one-mcp"]
}
}
```
### Installing via local source code
1. Clone this repository:
```bash
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:
```bash
uv sync
```
4. Add the following configuration:
```json
"mcpServers": {
"akshare-one-mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/akshare-one-mcp",
"run",
"akshare-one-mcp"
]
}
}
```