# AKTools

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1578 repo stars
- Author: akfamily
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akfamily/aktools
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/aktools

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add aktools -- uvx aktools
```
uvx runs the command named after the package; if the README names another one, use uvx --from aktools <command>

### Codex

**Platform CLI**
```bash
codex mcp add aktools -- uvx aktools
```
uvx runs the command named after the package; if the README names another one, use uvx --from aktools <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add aktools uvx aktools
```
uvx runs the command named after the package; if the README names another one, use uvx --from aktools <command>

## When to use it
- 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
- Find the AKTools interface for daily stock prices and show its parameters.
- Pull the daily history for `600000` and save it as CSV.
- Which AKShare interfaces deal with convertible bonds?

## Similar
- [alphaear-stock](https://affpapa.org/en/nevibecode/skills/alphaear-stock.md) — skill · 1300 installs
- [TokenBel Financial Data](https://affpapa.org/en/nevibecode/mcp/tokenbel-financial-data.md) — MCP server · 2830 installs
- [Blocksize Market Data](https://affpapa.org/en/nevibecode/mcp/blocksize-market-data.md) — MCP server · 885 installs
- [Financial Modeling Prep](https://affpapa.org/en/nevibecode/mcp/financial-modeling-prep.md) — MCP server · 873 installs
- [IPOGrid Research](https://affpapa.org/en/nevibecode/mcp/ipogrid-research.md) — MCP server · 653 installs
- [helium-mcp](https://affpapa.org/en/nevibecode/mcp/helium-mcp.md) — MCP server · 204 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
