AKShare One MCP
MCP server for Chinese stock market data on akshare-one: quotes, news, financial statements and insider trades
- 247 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The server reads market data from external sources and has no access to trading accounts or funds
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/akshare-one-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The server reads market data from external sources and has no access to trading accounts or funds
This is third-party code. Review the repository files before installing.
What it does
AKShare One MCP gives an agent Chinese stock market data through the akshare-one library. Nine tools: `get_hist_data` returns price history for periods from a minute to a year with adjustment for corporate actions and technical indicators, `get_realtime_data` gives current quotes, `get_news_data` brings news, `get_balance_sheet`, `get_income_statement` and `get_cash_flow` return the three statement forms, `get_financial_metrics` computes key ratios, `get_inner_trade_data` shows insider trades, and `get_time_info` reports the current time and the last trading day. Most tools have a `source` parameter with a preferred source and a `fallback` that is on by default: if the chosen source fails or returns an empty frame, the server tries the others in the same domain. For history the order is eastmoney, eastmoney_direct, sina, ths. Fields and their order do not change on a switch. It runs over stdio or over HTTP on port 8081.
Who it is for. Analysts and developers who study Chinese market stocks and want quotes and statements in a conversation with an agent.
Good fit when
- The agent compares a company's three statements over several years and writes a summary of revenue and debt growth
- You need price history for the ticker 000001 with indicators to analyze dynamics
- News on a security and insider trades are gathered into one note before a review
- An analytics script moves into the conversation: the same sources with automatic switching on failure
Not a fit when
- You need trading or order placement: the server only reads data
- You need quotes for markets outside China: the tools are built for Chinese securities
- You need an accuracy guarantee for money decisions: data comes from external sources unchecked by the server
Example request
Take the income statement and balance sheet of company 000001 for the last three years and show revenue and liabilities dynamicsMCP
- Transport
- stdio, http
- Authentication
- not required
Limitations
The server does not trade and gives no investment advice, it only reads data from external sources: eastmoney, sina, ths and xueqiu. Sources may change format, throttle frequent requests or return empty tables, so automatic switching turns on after a failure, and to pin the exact origin of numbers it is switched off with `fallback=false`. `get_inner_trade_data` has a single source. Running it needs Python 3.12 or newer and `uv`. The actual source is logged under `akshare_one_mcp.providers`. The license is MIT.
How to disable. Remove the akshare-one-mcp block from the client config (`claude mcp remove akshare-one-mcp`). The package is fetched through `uvx` and leaves no data on disk.
FAQ
How do I connect AKShare One MCP?
Add a server with the `uvx` command and the argument `akshare-one-mcp` to the client. For Claude Code: `claude mcp add akshare-one-mcp -- uvx akshare-one-mcp`. Python 3.12 or newer is required.
Which data sources does the server use?
For history eastmoney, eastmoney_direct, sina and ths, for real time also xueqiu, for news eastmoney and ths, for statements sina and eastmoney_direct. The order is set by the `source` parameter.
How do I turn off source switching?
Pass `fallback` as false: a failure of the chosen source then surfaces directly and you will know where the numbers came from.
How do I run the server over HTTP?
With the `--streamable-http` flag, the default address is `http://0.0.0.0:8081/mcp`. Host and port are changed with `--host` and `--port`.
Can I install through Smithery?
Yes, for Claude Desktop: `npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude`. The non-Smithery alternative is `uvx akshare-one-mcp`.
Discussion
No questions or reviews yet.
Related
MCP serversAn akshare-based MCP server with quotes, indicators and news for China, Hong Kong and US stocks, plus cryptocurrency data
MCP server and HTTP API on AKShare: the agent finds Chinese market data interfaces, reads their parameters and fetches tables
A server feeds agents quotes for A-shares, Hong Kong and US stocks, indicators, funds, futures and options, plus four skills.
A hosted MCP server for financial data: quotes, filings, macro statistics and FTShare's own factors, read-only
A local database of China A-share and ETF market data with an MCP server for natural-language queries
MCP lets an agent read a local Chinese-market archive and inspect financial data coverage, provenance and dates
README in short
The text presents the server as a set of interfaces to Chinese market data: history, real time, news and statements. Next come a table of automatic source switching, descriptions of nine tools with parameters and three ways to install: Smithery, `uvx` and a local repository copy.