akshare_mcp

Name: akshare_mcp
Author: wukan1986

@wukan1986

Repository

About akshare_mcp

AKShare的MCP Server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "akshare_mcp": {
      "command": "D:\\Users\\Kan\\miniconda3\\envs\\py312\\python.exe",
      "args": [
        "-m",
        "akshare_mcp",
        "--format",
        "markdown"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is akshare_mcp?

akshare_mcp is an MCP (Model Context Protocol) server wrapper that exposes all data interfaces from the AKShare financial data library as tools for MCP clients. It is built for users who need access to AKShare's full dataset without manually limiting to a small subset.

How to use akshare_mcp?

Install via pip install akshare_mcp or uv pip install akshare_mcp, then run python -m akshare_mcp -h to verify installation and note the configuration file path. In your MCP client’s JSON configuration, set the command to your Python interpreter and args to ["-m", "akshare_mcp", "--format", "markdown"]. To avoid excessive token usage, edit the config.py file (found via -h) to list only the interfaces you need, or use --config <path> to point to a custom config file. After editing, reconnect the MCP client.

Key features of akshare_mcp

Exposes all 1,000+ AKShare data interfaces as MCP tools
Supports custom selection of interfaces via configuration files
Outputs data in markdown format for readability
Allows external configuration file path via --config parameter
Compatible with any MCP client that supports tool invocation

Use cases of akshare_mcp

Retrieve financial market data (e.g., stock prices, fundamentals) through an AI assistant
Integrate AKShare’s extensive dataset into chatbot or agent workflows
Selectively activate only relevant data interfaces to control token consumption
Use with MCP clients that enforce a limit on the number of tools (e.g., Trae’s 40-tool cap)

FAQ from akshare_mcp

Why does akshare_mcp expose all interfaces?

AKShare provides thousands of data interfaces, but existing MCP servers only offer a small subset. This project exposes all interfaces for maximum flexibility, though users are advised to configure only the ones they need.

How do I configure which interfaces to use?

Run python -m akshare_mcp -h to find the configuration file path (typically site-packages/akshare_mcp/config.py). Edit that file to add the desired interface names (see the AKShare documentation for available names). If you lack write permissions, copy the config file to another location and use --config <path>.

Will using all tools consume a lot of tokens?

Yes. Exposing 1,000+ tools will consume a large number of tokens. Some MCP clients also limit the number of tools they support (e.g., Trae supports at most 40). Always configure only the required interfaces before use.

What are the runtime requirements?

The server runs on Python 3 (tested with Miniconda). It depends on the akshare_mcp package and its dependencies, including akshare itself.

How do I refresh the service after configuration?

After editing the configuration file, simply disconnect and reconnect the MCP client to the server. The server reloads the configuration on each connection.