mcp_akshare

What is mcp_akshare?

mcp_akshare is an MCP (Model Context Protocol) server wrapper that exposes all data interfaces from the AKShare financial data library as tools. It is intended for developers and data analysts who want to query AKShare’s 1,000+ datasets through an MCP‑compatible client.

How to use mcp_akshare?

Install via pip install mcp_akshare, then verify by running python -m mcp_akshare -h. Configure the MCP client (e.g., in a mcpServers JSON block) with the command pointing to your Python executable and the arguments -m mcp_akshare --format markdown. Before using, edit the server’s configuration file (located via -h) to specify which AKShare interfaces to activate; otherwise, all 1,000+ tools will be exposed, consuming excessive tokens.

Key features of mcp_akshare

• Wraps all 1,000+ AKShare data interfaces as MCP tools
• Output format can be set to markdown via --format markdown
• Users select which interfaces to expose to control token usage
• Simple pip installation and command‑line verification
• Client‑side JSON configuration for the MCP server definition

Use cases of mcp_akshare

• Query financial market data (stocks, funds, futures) through a language model client
• Build automated research workflows that fetch AKShare datasets on demand
• Integrate AKShare’s broad data catalog into MCP‑enabled IDEs or chat interfaces
• Reduce token consumption by pre‑selecting only the needed AKShare interfaces

FAQ from mcp_akshare

How many tools does mcp_akshare expose?

It exposes all AKShare data interfaces as tools – over 1,000 in total. However, exposing all at once may consume a large number of tokens and some MCP clients (e.g., Trae) support a maximum of 40 tools.

How do I limit which interfaces are available?

First run python -m mcp_akshare -h to find the configuration file location. Edit that file and add only the interface names you need (see the AKShare documentation for valid names). Restart the server for the change to take effect.

What dependencies or runtime does mcp_akshare require?

The README only states a Python environment with mcp_akshare installed via pip. No additional runtime requirements or system dependencies are mentioned.

Where does the retrieved data come from?

All data comes from the AKShare library, which in turn fetches it from public Chinese financial data sources. The MCP server does not store or cache data locally.

What transport or authentication does mcp_akshare use?

The README does not specify any transport protocol or authentication method. It is assumed to use the standard MCP transport (stdio via the configured command).