{
  "markdown": "# AKShare One MCP Server\n\n<div align=\"center\">\n  <a href=\"README.md\">English</a> | \n  <a href=\"README_zh.md\">中文</a>\n</div>\n\n<!-- mcp-name: io.github.zwldarren/akshare-one-mcp -->\n\n[![smithery badge](https://smithery.ai/badge/@zwldarren/akshare-one-mcp)](https://smithery.ai/server/@zwldarren/akshare-one-mcp)\n\n## Overview\n\nAn MCP server based on [akshare-one](https://github.com/zwldarren/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.\n\n<a href=\"https://glama.ai/mcp/servers/@zwldarren/akshare-one-mcp\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@zwldarren/akshare-one-mcp/badge\" alt=\"akshare-one-mcp MCP server\" />\n</a>\n\n## Available Tools\n\n### Market Data Tools\n\n#### `get_hist_data`\nGet historical stock market data with support for multiple time periods and adjustment methods.\n\n<details>\n<summary>Parameters</summary>\n\n- `symbol` (string, required): Stock code (e.g. '000001')\n- `interval` (string, optional): Time interval ('minute','hour','day','week','month','year') (default: 'day')\n- `interval_multiplier` (number, optional): Interval multiplier (default: 1)\n- `start_date` (string, optional): Start date in YYYY-MM-DD format (default: '1970-01-01')\n- `end_date` (string, optional): End date in YYYY-MM-DD format (default: '2030-12-31')\n- `adjust` (string, optional): Adjustment type ('none', 'qfq', 'hfq') (default: 'none')\n- `source` (string, optional): Data source ('eastmoney', 'eastmoney_direct', 'sina') (default: 'eastmoney')\n- `indicators_list` (list, optional): Technical indicators to add\n- `recent_n` (number, optional): Number of most recent records to return (default: 100)\n\n</details>\n\n#### `get_realtime_data`\nGet real-time stock market data.\n\n<details>\n<summary>Parameters</summary>\n\n- `symbol` (string, optional): Stock code\n- `source` (string, optional): Data source ('xueqiu', 'eastmoney', 'eastmoney_direct') (default: 'eastmoney_direct')\n\n</details>\n\n### News & Information Tools\n\n#### `get_news_data`\nGet stock-related news data.\n\n<details>\n<summary>Parameters</summary>\n\n- `symbol` (string, required): Stock code\n- `recent_n` (number, optional): Number of most recent records to return (default: 10)\n\n</details>\n\n### Financial Statement Tools\n\n#### `get_balance_sheet`\nGet company balance sheet data.\n\n<details>\n<summary>Parameters</summary>\n\n- `symbol` (string, required): Stock code\n- `recent_n` (number, optional): Number of most recent records to return (default: 10)\n\n</details>\n\n#### `get_income_statement`\nGet company income statement data.\n\n<details>\n<summary>Parameters</summary>\n\n- `symbol` (string, required): Stock code\n- `recent_n` (number, optional): Number of most recent records to return (default: 10)\n\n</details>\n\n#### `get_cash_flow`\nGet company cash flow statement data.\n\n<details>\n<summary>Parameters</summary>\n\n- `symbol` (string, required): Stock code\n- `source` (string, optional): Data source (default: 'sina')\n- `recent_n` (number, optional): Number of most recent records to return (default: 10)\n\n</details>\n\n### Analysis & Metrics Tools\n\n#### `get_inner_trade_data`\nGet company insider trading data.\n\n<details>\n<summary>Parameters</summary>\n\n- `symbol` (string, required): Stock code\n\n</details>\n\n#### `get_financial_metrics`\nGet key financial metrics from the three major financial statements.\n\n<details>\n<summary>Parameters</summary>\n\n- `symbol` (string, required): Stock code\n- `recent_n` (number, optional): Number of most recent records to return (default: 10)\n\n</details>\n\n#### `get_time_info`\nGet current time with ISO format, timestamp, and the last trading day.\n\n## Installation & Setup\n\n### Running Modes\n\nThe server supports two modes: stdio and streamable-http\n\n**Command Line Arguments:**\n- `--streamable-http`: Enable HTTP mode (default: stdio mode)\n- `--host`: Host to bind to in HTTP mode (default: 0.0.0.0)\n- `--port`: Port to listen on in HTTP mode (default: 8081)\n\n> **Note:** When using streamable-http mode, the MCP server will be available at `http://{host}:{port}/mcp`. For the default configuration, this would be `http://0.0.0.0:8081/mcp`.\n\n### Installation Options\n\n#### Option 1: Via Smithery\nTo install akshare-one-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@zwldarren/akshare-one-mcp):\n\n```bash\nnpx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude\n```\n\n#### Option 2: Via `uv`\nInstall [uv](<https://docs.astral.sh/uv/getting-started/installation/>) if you haven't already.\n\nAdd the following configuration to your MCP Client settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"akshare-one-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"akshare-one-mcp\"]\n    }\n  }\n}\n```\n\n#### Option 3: Local Development Setup\n\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/zwldarren/akshare-one-mcp.git\n   cd akshare-one-mcp\n   ```\n\n2. Install dependencies:\n   ```bash\n   uv sync\n   ```\n\n3. Add the following configuration to your MCP Client settings:\n   ```json\n   {\n     \"mcpServers\": {\n       \"akshare-one-mcp\": {\n         \"command\": \"uv\",\n         \"args\": [\n           \"--directory\",\n           \"/path/to/akshare-one-mcp\",\n           \"run\",\n           \"akshare-one-mcp\"\n         ]\n       }\n     }\n   }\n   ```\n\n## Technical Indicators Reference\n\nThe `get_hist_data` tool supports the following technical indicators:\n\n### Trend Indicators\n- **Moving Averages**: SMA (Simple Moving Average), EMA (Exponential Moving Average)\n- **Trend Tracking**: MACD (Moving Average Convergence Divergence), APO (Absolute Price Oscillator), PPO (Percentage Price Oscillator)\n- **Rate of Change**: ROC (Rate of Change), ROCP (Rate of Change Percentage), ROCR (Rate of Change Ratio), ROCR100\n- **Other**: TRIX (Triple Exponential Moving Average), ULTOSC (Ultimate Oscillator)\n\n### Momentum Indicators\n- **Relative Strength**: RSI (Relative Strength Index), CCI (Commodity Channel Index)\n- **Trend Strength**: ADX (Average Directional Index), DX (Directional Index)\n- **Money Flow**: MFI (Money Flow Index), MOM (Momentum), CMO (Chande Momentum Oscillator), WILLR (Williams %R)\n\n### Volatility Indicators\n- **Bollinger Bands**: BOLL (Bollinger Bands)\n- **Average True Range**: ATR (Average True Range)\n- **Parabolic SAR**: SAR (Parabolic Stop and Reverse)\n\n### Volume Indicators\n- **Volume**: OBV (On-Balance Volume), AD (Accumulation/Distribution Line), ADOSC (Accumulation/Distribution Oscillator)\n\n### Other Indicators\n- **Stochastic**: STOCH (Stochastic Oscillator)\n- **Aroon**: AROON (Aroon Indicator), AROONOSC (Aroon Oscillator)\n- **Balance of Power**: BOP (Balance of Power)\n- **Directional Indicators**: MINUS_DI, MINUS_DM, PLUS_DI, PLUS_DM\n- **Time Series Forecast**: TSF (Time Series Forecast)\n",
  "bytes": 6845,
  "sha": "6ca702b9eb3e6384e3a56d35d3850ab1aaf0ecf0ef24defbd9a9ba33c593300d",
  "repo_slug": "zwldarren/akshare-one-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_smithery_zwldarren_akshare_one_mcp_8a654d7a/readme"
}