Akshare One MCP

🚀 Akshare-one-based MCP Server

This MCP server, built on akshare-one, offers Chinese stock market data interfaces. It provides a series of tools for obtaining financial information, including historical stock data, real-time data, news data, financial statements, etc.

✨ Features

get_hist_data

Retrieve 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 the format of YYYY-MM-DD (default: '1970-01-01')
• end_date (string, optional): End date in the format of YYYY-MM-DD (default: '2030-12-31')
• adjust (string, optional): Adjustment type ('none', 'qfq', 'hfq') (default: 'none')
• source (string, optional): Data source ('eastmoney', 'sina') (default: 'eastmoney')

get_realtime_data

Retrieve real-time stock data. Input parameters:

• symbol (string, optional): Stock code
• source (string, optional): Data source (default: 'eastmoney')

get_news_data

Retrieve news data related to stocks. Input parameters:

• symbol (string): Stock code
• source (string, optional): Data source (default: 'eastmoney')

get_balance_sheet

Retrieve a company's balance sheet data. Input parameters:

• symbol (string): Stock code
• source (string, optional): Data source (default: 'sina')

get_income_statement

Retrieve a company's income statement data. Input parameters:

• symbol (string): Stock code
• source (string, optional): Data source (default: 'sina')

get_cash_flow

Retrieve a company's cash flow statement data. Input parameters:

• symbol (string): Stock code
• source (string, optional): Data source (default: 'sina')

get_inner_trade_data

Retrieve a company's insider trading data. Input parameters:

• symbol (string, optional): Stock code
• source (string, optional): Data source (default: 'xueqiu')

📦 Installation

Install via Smithery

To automatically install akshare-one-mcp for Claude Desktop via Smithery:

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

Preparation

1. Clone this repository:

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

2. Install uv if not already installed.
3. Install dependencies:

uv sync

💻 Usage Examples

Connect to any MCP client

Add the following configuration to the MCP server configuration file:

{
  "configuration": {
    "akshare_one_mcp_server": {
      "host": "localhost",
      "port": 3000
    }
  }
}

Use it in your code:

const { akshareOneMCPClient } = require('@zwldarren/akshare-one-mcp-client');
async function main() {
  const client = new akshareOneMCPClient({
    configuration: {
      akshare_one_mcp_server: {
        host: 'localhost',
        port: 3000
      }
    }
  });
  // Use the tools for operations, for example:
  await client.getHistData({ symbol: 'AAPL' });
}
main().catch(console.error);