akshare-one

The AKShare One MCP Server provides a collection of market data tools built on top of the akshare-one project. It exposes endpoints to fetch historical stock data, real-time quotes, stock news, and key financial statements, along with analysis utilities. You can call functions like get_hist_data, get_realtime_data, get_news_data, get_balance_sheet, get_income_statement, get_cash_flow, get_inner_trade_data, get_financial_metrics, and get_time_info to retrieve structured financial information and indicators. The server supports multiple data sources and adjustment methods, and includes a suite of technical indicators that can be applied to historical data for analysis. To use it, connect your MCP client to the akshare-one-mcp server and invoke the desired tool with the required parameters. The server can run in stdio mode or in streamable-http mode, allowing HTTP access to /mcp when enabled.

Prerequisites:

• Node.js (recommended LTS) and npm/yarn installed
• Basic knowledge of MCP client configuration

Option 1: Via Smithery (recommended for quick setup)

npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude

Option 2: Via uv (for uv-based runtimes)

# Ensure uv is installed
# Then configure MCP client to run the server via uv

Option 3: Local Development Setup

1. Clone the repository:

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

2. Install dependencies (if applicable):

uv sync

3. Run the server locally (example configuration for MCP client):

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

4. To run via Smithery or uv, follow the respective commands from Option 1 or Option 2. The key is to ensure the MCP client can launch the akshare-one-mcp process with the correct working directory and entrypoint.

Notes:

• The server exposes multiple data tools; refer to the README for the exact parameters of each tool (e.g., symbol, interval, start_date, end_date, source, recent_n, etc.).
• If you enable streamable-http mode, the MCP API will be accessible at http://{host}:{port}/mcp (default host 0.0.0.0 and port 8081 as per README).
• Common environment considerations include network access to data sources and the ability to reach external data endpoints supported by akshare-one.
• If you encounter authentication or API limits from data sources, adjust the source parameter in the tool calls (e.g., eastmoney, sina, xueqiu) as described in the tool documentation.
• You can customize the host/port in HTTP mode using command line flags as indicated in the README: --host and --port.