AKTools — Claude Code MCP server: what it does, how to install
AKTools is an MCP server with three AKShare tools: the assistant finds the right interface, reads its arguments and fetches stock, futures, fund or macro data.
MIT ★ 1,578 updated 2026-10-29
claude mcp add aktools -- uvx aktoolsWhat AKTools does
AKTools wraps AKShare in three MCP tools. search_interfaces finds a function by keyword, describe_interface lists its arguments, get_data returns the rows. You ask in plain language and the assistant works out which function to call.
The same catalogue is reachable over HTTP. After pip install aktools, running python -m aktools starts the service on http://127.0.0.1:8080, and each endpoint mirrors an AKShare function name, for example http://127.0.0.1:8080/api/public/stock_zh_a_hist?symbol=600000. Results stay cached for 60 seconds, which keeps repeated calls off the upstream site.
The MCP route needs no local install of the package: the assistant launches the server through uvx. That only works when uv is already on the machine. First start downloads dependencies, roughly 150 MB, so expect a few minutes. The HTTP route asks for 64-bit Python 3.11 or newer.
What it helps with
- Pull daily quotes for a ticker over a date range
- Find the right interface by keyword
- Check which arguments an interface expects and what they default to
- Dump a result to CSV or Excel through
_format - Hand the same JSON to a script in another language
Example prompts for the agent
- Find the AKTools interface for daily stock prices and show its parameters.
- Pull the daily history for
600000and save it as CSV. - Which AKShare interfaces deal with convertible bonds?
How to install AKTools
Platform CLI
claude mcp add aktools -- uvx aktoolsuvx runs the command named after the package; if the README names another one, use uvx --from aktools <command>
Platform CLI
codex mcp add aktools -- uvx aktoolsuvx runs the command named after the package; if the README names another one, use uvx --from aktools <command>
Config file
{
"mcpServers": {
"aktools": {
"command": "uvx",
"args": [
"aktools"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from aktools <command>
Config file
{
"servers": {
"aktools": {
"type": "stdio",
"command": "uvx",
"args": [
"aktools"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from aktools <command>
Platform CLI
gemini mcp add aktools uvx aktoolsuvx runs the command named after the package; if the README names another one, use uvx --from aktools <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AKTools
How do I install AKTools in Claude Code?
Run claude mcp add aktools -- uvx aktools. Install uv first, then restart the assistant.
What does AKTools do?
It gives the assistant access to AKShare data through three tools. search_interfaces locates a function, describe_interface shows its arguments, and get_data returns the result as JSON.
Do I need to install the AKTools package before connecting it?
No. uvx fetches and runs the server itself, so there is no separate install or manual start. The first launch pulls about 150 MB of dependencies.