Z
zwldarren/akshare-one-mcp
Chinese stock data through akshare-one
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Remote endpoint (mcpServers - Claude Desktop / Cursor / Windsurf)
{
"mcpServers": {
"zwldarren-akshare-one-mcp": {
"url": "https://server.smithery.ai/@zwldarren/akshare-one-mcp/mcp"
}
}
}Paste this into the mcpServers config of Claude Desktop or Cursor. The endpoint comes from public evidence; we do not install or host it. Official Registry record: this endpoint declares a required request header Authorization (Bearer token for Smithery authentication). Using it means bringing your own credentials.
VS Code (.vscode/mcp.json - the key is servers, remote needs type: http)
{
"servers": {
"zwldarren-akshare-one-mcp": {
"type": "http",
"url": "https://server.smithery.ai/@zwldarren/akshare-one-mcp/mcp"
}
}
}VS Code differs from the other three: the top-level key is <code>servers</code> and a remote endpoint also needs <code>"type": "http"</code>. Paste into .vscode/mcp.json.
Claude Code (command line)
claude mcp add --transport http zwldarren-akshare-one-mcp https://server.smithery.ai/@zwldarren/akshare-one-mcp/mcp
Claude Code does not read a config file; add the server with this command.
Client config (built from the install command this repo gives)
{
"mcpServers": {
"zwldarren-akshare-one-mcp": {
"command": "npx",
"args": ["-y", "@smithery/cli"]
}
}
}Parsed from the README we fetched on 2026-11-06; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"zwldarren-akshare-one-mcp": {
"command": "npx",
"args": ["-y", "@smithery/cli"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio zwldarren-akshare-one-mcp -- npx -y @smithery/cli
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Source
- collected from the abordage/awesome-mcp list · type: MCP server
- Harvest history
- first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 10 sources
- Score
- score 1,003 · 10 sources · mcp
- Install
npx -y @smithery/cli
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx -y @smithery/cli. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
first catalogued 2026-11-05;last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.
# AKShare One MCP Server
以下摘录自该仓库的 README(片段) · 在 GitHub 读完整 README →
English |
中文
## Overview
An MCP server based on akshare-one, providing comprehensive interfaces for China stock market data. It offers a set of powerful tools for retrieving financial information including historical stock data, real-time data, news data, and financial statements.
## Available Tools
### Automatic source fallback
Except for getinnertradedata, whose upstream exposes a single source, every data tool takes a source parameter for the preferred data source and a fallback parameter (on by default) that decides whether the other sources of the same domain are tried when that source raises or returns an empty frame:
| Domain | Order tried |
| Historical | eastmoney → eastmoneydirect → sina → ths |
| Real-time | eastmoneydirect → eastmoney → xueqiu → ths (the last two are skipped when no symbol is given) |
| News | eastmoney → ths |
| Financial statements | sina ⇄ eastmoneydirect |
The requested source is always tried first; the order only governs the fallback. Because akshare-one projects every source onto its domain's declared columns, falling back cannot change the field names or their order. When every source fails, the error lists each one and why it failed; when every source succeeds but has no data, an empty result is returned. Set fallback to false to pin a single source — a failure then surfaces directly, which is useful when you need to know exactly where the numbers came from.
The source that actually served a call is logged under the akshareonemcp.providers logger.
### Market Data Tools
#### gethistdata
Get historical stock market data with support for multiple time periods and adjustment methods.
Parameters
symbol (string, required): Stock code (e.g. '000001')
interval (string, optional): Time interval ('minute','hour','day','week','month','year') (default: 'day')
intervalmultiplier (number, optional): Interval multiplier (default: 1)
startdate (string, optional): Start date in YYYY-MM-DD format (default: '1970-01-01')
enddate (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', 'eastmoneydirect', 'sina', 'ths') (default: 'eastmoney')
fallback (boolean, optional): Try 'eastmoney', 'eastmoneydirect', 'sina' and 'ths' in order when the chosen source fails or has no data (default: true)
indicatorslist (list, optional): Technical indicators to add
recentn (number, optional): Number of most recent records to return (default: 100)
#### getrealtimedata
Get real-time stock market data.
Parameters
symbol (string, optional): Stock code
source (string, optional): Data source ('eastmoneydirect', 'eastmoney', 'xueqiu', 'ths') (default: 'eastmoneydirect')
fallback (boolean, optional): Try 'eastmoneydirect', 'eastmoney', 'xueqiu' and 'ths' in order when the chosen source fails or has no data (default: true; 'xueqiu' and 'ths' are skipped when no symbol is given, as they quote one symbol at a time)
### News & Information Tools
#### getnewsdata
Get stock-related news data.
Parameters
symbol (string, required): Stock code
source (string, optional): Data source ('eastmoney', 'ths') (default: 'eastmoney')
中文
## Overview
An MCP server based on akshare-one, providing comprehensive interfaces for China stock market data. It offers a set of powerful tools for retrieving financial information including historical stock data, real-time data, news data, and financial statements.
## Available Tools
### Automatic source fallback
Except for getinnertradedata, whose upstream exposes a single source, every data tool takes a source parameter for the preferred data source and a fallback parameter (on by default) that decides whether the other sources of the same domain are tried when that source raises or returns an empty frame:
| Domain | Order tried |
| Historical | eastmoney → eastmoneydirect → sina → ths |
| Real-time | eastmoneydirect → eastmoney → xueqiu → ths (the last two are skipped when no symbol is given) |
| News | eastmoney → ths |
| Financial statements | sina ⇄ eastmoneydirect |
The requested source is always tried first; the order only governs the fallback. Because akshare-one projects every source onto its domain's declared columns, falling back cannot change the field names or their order. When every source fails, the error lists each one and why it failed; when every source succeeds but has no data, an empty result is returned. Set fallback to false to pin a single source — a failure then surfaces directly, which is useful when you need to know exactly where the numbers came from.
The source that actually served a call is logged under the akshareonemcp.providers logger.
### Market Data Tools
#### gethistdata
Get historical stock market data with support for multiple time periods and adjustment methods.
Parameters
symbol (string, required): Stock code (e.g. '000001')
interval (string, optional): Time interval ('minute','hour','day','week','month','year') (default: 'day')
intervalmultiplier (number, optional): Interval multiplier (default: 1)
startdate (string, optional): Start date in YYYY-MM-DD format (default: '1970-01-01')
enddate (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', 'eastmoneydirect', 'sina', 'ths') (default: 'eastmoney')
fallback (boolean, optional): Try 'eastmoney', 'eastmoneydirect', 'sina' and 'ths' in order when the chosen source fails or has no data (default: true)
indicatorslist (list, optional): Technical indicators to add
recentn (number, optional): Number of most recent records to return (default: 100)
#### getrealtimedata
Get real-time stock market data.
Parameters
symbol (string, optional): Stock code
source (string, optional): Data source ('eastmoneydirect', 'eastmoney', 'xueqiu', 'ths') (default: 'eastmoneydirect')
fallback (boolean, optional): Try 'eastmoneydirect', 'eastmoney', 'xueqiu' and 'ths' in order when the chosen source fails or has no data (default: true; 'xueqiu' and 'ths' are skipped when no symbol is given, as they quote one symbol at a time)
### News & Information Tools
#### getnewsdata
Get stock-related news data.
Parameters
symbol (string, required): Stock code
source (string, optional): Data source ('eastmoney', 'ths') (default: 'eastmoney')
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/zwldarren-akshare-one-mcp/)
- Source
- awesome · https://github.com/zwldarren/akshare-one-mcp
- Browse by field
- MCP servers
- Listed by
- 10 independent sources
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.