MCP Server

Maintained

MIT

AkTools MCP Server MCP Server

io.github.aahl/mcp-aktools

Query stock, crypto prices, financial indicators, and market news via akshare through MCP.

What is the AkTools MCP Server MCP server?

AkTools MCP Server is a Model Context Protocol server built on the akshare library that provides stock and cryptocurrency data query and analysis capabilities. It supports querying A-share, Hong Kong, and US stock information, market data, financial indicators, and crypto prices from sources like OKX and Binance. It can be run via uvx, Smithery, or Docker, and connected to MCP clients like Claude, Cursor, or VS Code.

AkTools MCP Server wraps the akshare data library into an MCP-compatible interface, letting AI agents look up stock codes, retrieve detailed stock info, historical prices with technical indicators, financial metrics for A-share/HK/US markets, market overview data (limit-up pools, capital flow, dragon-tiger list), news/financial headlines, and cryptocurrency data (prices, long/short ratios, taker volume, AI reports) from OKX and Binance. It's intended for building financial analysis and trading-assistant workflows inside MCP clients like Claude, Cursor, or VS Code.

How to install AkTools MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-aktools": {
      "command": "uvx",
      "args": [
        "mcp-aktools"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-aktools": {
      "command": "uvx",
      "args": [
        "mcp-aktools"
      ]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-aktools": {
      "command": "uvx",
      "args": [
        "mcp-aktools"
      ]
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-aktools": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-aktools"
      ]
    }
  }
}

Claude Code

claude mcp add mcp-aktools -- uvx mcp-aktools

Tools & capabilities

Tools this server exposes to the agent.

search — 查找股票代码，支持A股、港股、美股
stock_info — 获取股票信息
stock_prices — 获取股票历史价格
stock_indicators_a — A股关键指标
stock_indicators_hk — 港股关键指标
stock_indicators_us — 美股关键指标
trading_suggest — 给出投资建议
get_current_time — 获取当前时间及A股交易日信息
stock_zt_pool_em — A股涨停股池
stock_zt_pool_strong_em — A股强势股池
stock_lhb_ggtj_sina — A股龙虎榜统计
stock_sector_fund_flow_rank — A股概念资金流向
stock_news — 获取个股/加密货币相关新闻
stock_news_global — 全球财经快讯
okx_prices — 获取加密货币历史价格
okx_loan_ratios — 获取加密货币杠杆多空比
okx_taker_volume — 获取加密货币主动买卖情况
binance_ai_report — 获取加密货币AI分析报告

Use cases

Look up a stock's ticker code by company name across A-share, HK, and US markets
Retrieve historical price data with technical indicators for a stock or cryptocurrency
Check A-share limit-up pools, dragon-tiger list stats, and sector capital flow rankings
Get key financial indicators/reports for A-share, HK, or US listed companies
Fetch recent news and global financial flash updates for a stock or crypto asset
Get crypto long/short ratios, taker buy/sell volume, and AI-generated market reports from OKX/Binance

AkTools MCP Server MCP server FAQ

What does the AkTools MCP Server do?

It exposes akshare-based financial data as MCP tools, letting AI agents search stock codes, fetch stock/crypto prices and indicators, check A-share market activity (limit-up pools, capital flow, dragon-tiger list), and read financial news for A-share, HK, US stocks and cryptocurrencies.

Is AkTools MCP Server free to use?

Yes, it is an open-source project available on PyPI (mcp-aktools) and as a Docker image (ghcr.io/aahl/mcp-aktools), free to self-host. Some optional data sources like Smithery hosting may require an API key or OAuth.

How do I install AkTools MCP Server in Cursor?

Use the provided Cursor deep link/install button, or manually add it via uvx by configuring a Cursor MCP server entry with command 'uvx' and args ['mcp-aktools'].

How do I install AkTools MCP Server in Claude Code?

Run the command: `claude mcp add aktools -- uvx mcp-aktools`.

Does AkTools require authentication?

Running locally via uvx or Docker requires no authentication. Using the hosted Smithery URL requires OAuth authorization or a Smithery key.

Can I customize data sources like OKX or Binance endpoints?

Yes, environment variables such as OKX_BASE_URL, BINANCE_BASE_URL, NEWSNOW_BASE_URL, and NEWSNOW_CHANNELS can be set to configure custom or proxy endpoints for these data sources.

README (reference)

Source of truth, from the repository.

📈 AkTools MCP Server

基于 akshare 的 MCP (Model Context Protocol) 服务器，提供股票、加密货币的数据查询和分析功能。

功能

🔍 股票搜索: 根据股票名称、公司简称等关键词查找股票代码
ℹ️ 股票信息: 获取股票的详细信息，包括价格、市值等
📊 市场概况: 获取A股市场的涨停板、龙虎榜、资金流向等
💹 历史价格: 获取股票、加密货币历史价格数据，包含技术分析指标
📰 相关新闻: 获取股票、加密货币相关的最新新闻资讯
💸 财务指标: 支持A股和港美股的财务报告关键指标查询

安装

方式1: uvx

{
  "mcpServers": {
    "aktools": {
      "command": "uvx",
      "args": ["mcp-aktools"],
      "env": {
        # 全部可选
        "OKX_BASE_URL": "https://okx.4url.cn", # OKX地址，如果你的网络环境无法访问okx.com，可通过此选项配置反代地址
        "BINANCE_BASE_URL": "https://bian.4url.cn", # 币安地址，默认: https://www.binance.com
        "NEWSNOW_BASE_URL": "https://newsnow.busiyi.world", # Newsnow接口地址
        "NEWSNOW_CHANNELS": "wallstreetcn-quick,cls-telegraph,jin10", # Newsnow资讯来源
      }
    }
  }
}

方式2: Smithery

需要通过OAuth授权或Smithery key

{
  "mcpServers": {
    "aktools": {
      "url": "https://server.smithery.ai/@aahl/mcp-aktools/mcp" # Streamable HTTP
    }
  }
}

方式3: Docker

mkdir /opt/mcp-aktools
cd /opt/mcp-aktools
wget https://raw.githubusercontent.com/aahl/mcp-aktools/refs/heads/main/docker-compose.yml
docker-compose up -d

{
  "mcpServers": {
    "aktools": {
      "url": "http://0.0.0.0:8808/mcp" # Streamable HTTP
    }
  }
}

快速开始

在线体验:
在线体验:
添加到 Cursor
添加到 VS Code
添加到 Cherry Studio
添加到 Claude Code, 执行命令: claude mcp add aktools -- uvx mcp-aktools
添加到 OpenAI CodeX, 执行命令: codex mcp add aktools -- uvx mcp-aktools

🛠️ 可用工具

search - 查找股票代码，支持A股、港股、美股
stock_info - 获取股票信息
stock_prices - 获取股票历史价格
stock_indicators_a - A股关键指标
stock_indicators_hk - 港股关键指标
stock_indicators_us - 美股关键指标
trading_suggest - 给出投资建议

</details> <details> <summary>A股市场</summary>

get_current_time - 获取当前时间及A股交易日信息
stock_zt_pool_em - A股涨停股池
stock_zt_pool_strong_em - A股强势股池
stock_lhb_ggtj_sina - A股龙虎榜统计
stock_sector_fund_flow_rank - A股概念资金流向

</details> <details> <summary>财经资讯</summary>

stock_news - 获取个股/加密货币相关新闻
stock_news_global - 全球财经快讯

</details> <details> <summary>加密货币</summary>

okx_prices - 获取加密货币历史价格
okx_loan_ratios - 获取加密货币杠杆多空比
okx_taker_volume - 获取加密货币主动买卖情况
binance_ai_report - 获取加密货币AI分析报告

</details>

Related MCP servers

Notify MCP Server

Maintained

MCP Server for notify to Weixin, Telegram, Bark, Lark, Feishu, DingTalk

Python

MIT

View repository →

MCP Server for Binge-watch

Maintained

MCP Server for Binge-watch / MoonTV / LunaTV. 一个用于追剧/追番的MCP服务器，为AI提供搜索影视播放地址的能力，并支持在小米等安卓电视/投影仪上直接播放

Python

MIT

View repository →

OKX MCP Server

Stale

MCP Server for okx.com

Python

MIT

View repository →