Skip to content

tchivs/aktools-pro

BranchesTags
 
 

Repository files navigation

📈 AkTools Pro MCP Server

让 AI 成为你的金融分析师
Empower your AI Agents with Professional Financial Intelligence

Version PyPI License Python FastMCP GitHub stars

功能亮点 • 系统架构 • 快速开始 • 工具一览 • 实战示例

AkTools Pro 是一个基于 akshare 的增强型 MCP (Model Context Protocol) 服务器。它不仅仅是一个数据接口，更是一个内置了专业金融分析逻辑、交易策略和可视化能力的 AI 技能库。

无论是 A 股、港美股、加密货币还是贵金属，AkTools Pro 都能让你的 AI Agent 像资深分析师一样思考和回答。

🌟 核心特性

🧠 智能技能引擎 💹 全球市场覆盖
内置 MCP Prompts 和 Resources，注入 "分析师" 人格与 SOP 标准流程。 一站式覆盖 A股、港股、美股、加密货币、贵金属 等主流投资品种。
📊 可视化增强 🛡️ 极致性能
支持在聊天界面直接绘制 ASCII 字符走势图，让数据趋势一目了然。 采用 内存 + 磁盘 双层缓存机制，毫秒级响应，智能保护数据源。
💼 实战模拟 🧪 策略实验室
内置虚拟持仓管理系统，支持 AI 自动跟踪 盈亏 (P&L) 与胜率统计。 内置回测引擎，支持验证 SMA / RSI / MACD / BOLL / KDJ / MA_CROSS 等经典交易策略。

🏗 系统架构

graph TD
    User((User / AI Agent)) <-->|MCP Protocol| Server[AkTools Pro Server]
    
    subgraph "Core Engine"
        Server --> Skills[Skill Injector]
        Server --> Cache[Dual-Layer Cache]
        Server --> Visual[Visual Engine]
        Server --> Logic[Backtest/Analysis]
    end
    
    subgraph "Data Sources"
        Cache <--> AkShare[AkShare API]
        Cache <--> OKX[OKX / Binance]
        Cache <--> News[Financial News]
    end
    
    Skills -->|SOPs & Prompts| User
    Visual -->|ASCII Charts| User
Loading

🚀 快速开始

选择最适合你的安装方式，30秒内即可启动。

📦 方式 1: 自动安装 (推荐)

在你的 AI 终端中根据客户端类型执行：

OpenCode (Sisyphus)

opencode mcp add
# 1. Location: Global
# 2. Name: aktools-pro
# 3. Type: Local
# 4. Command: uvx aktools-pro

Claude Code / OpenAI Codex

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

Cursor / VS Code

在 mcpServers 配置文件中添加：

"aktools-pro": {
  "command": "uvx",
  "args": ["aktools-pro"]
}
🐳 方式 2: Docker 部署

适合服务器环境或偏好隔离的用户：

mkdir /opt/aktools-pro
cd /opt/aktools-pro
wget https://raw.githubusercontent.com/tchivs/aktools-pro/main/docker-compose.yml
docker-compose up -d
⚙️ 环境变量配置
变量名 说明 默认值
OKX_BASE_URL OKX 代理地址 https://okx.com
BINANCE_BASE_URL 币安代理地址 https://www.binance.com
NEWSNOW_BASE_URL 资讯接口地址 https://newsnow.busiyi.world
TRANSPORT MCP 协议 stdio

🛠 工具一览

AkTools Pro 提供了 65 个专业工具，分为以下核心模块：

📈 股票 & 市场 (Stock & Market)

覆盖 A股/港股/美股 的行情与基本面

  • 基础: search (搜代码), stock_info (个股信息)
  • 行情: market_prices (历史K线), stock_zt_pool_em (涨停池)
  • 数据: stock_indicators (财务指标), stock_lhb (龙虎榜), northbound_funds (北向资金)
  • 分析: sector_valuation (行业估值), sector_rotation (板块轮动), market_anomaly_scan (异动扫描)

₿ 加密货币 (Crypto)

接入 OKX/Binance 的深度数据

  • 行情: crypto_prices (K线), draw_crypto_chart (字符图)
  • 情绪: fear_greed_index (恐贪指数), crypto_sentiment_metrics (情绪指标)
  • 衍生品: okx_funding_rate (资金费率), okx_open_interest (持仓量)
  • 智能: binance_ai_report (AI研报), crypto_composite_diagnostic (综合诊断)

🥇 贵金属 (Precious Metals)

黄金/白银的期现货数据

  • 价格: pm_spot_prices (现货), pm_international_prices (外盘)
  • 库存: pm_etf_holdings (ETF持仓), pm_comex_inventory (COMEX库存)
  • 分析: pm_basis (期现基差), pm_composite_diagnostic (综合诊断)

💱 外汇 (Forex)

全球汇率行情与历史数据

  • 行情: fx_rates (即期汇率/交叉汇率)
  • 历史: fx_history (历史汇率)

🏗️ 期货 (Futures)

商品与金融期货深度数据

  • 行情: futures_prices (K线数据)
  • 库存: futures_inventory (交易所库存)
  • 基差: futures_basis (期现基差)
  • 持仓: futures_positions (仓单日报)

🏦 基金 (Funds)

公募基金与 ETF 数据

  • 基础: fund_info (基本信息), fund_ranking (基金排行)
  • 业绩: fund_nav (净值走势)
  • 持仓: fund_holdings (重仓股)
  • ETF: market_prices (asset=etf)

🌍 宏观经济 (Macro)

全球与中国宏观经济指标

  • 核心: macro_gdp (国内生产总值), macro_cpi (消费者物价指数)
  • 景气: macro_pmi (采购经理指数)
  • 金融: macro_interest_rate (基准利率), macro_money_supply (货币供应量)

🧠 智能技能 (AI Skills)

让 AI 具备专业分析师的思维

  • 股票 Prompts: analyze-stock (个股诊断), market-pulse (市场脉搏)
  • 加密 Prompts: analyze-crypto (币种分析), crypto-pulse (币圈脉搏)
  • 贵金属 Prompts: analyze-precious-metal (贵金属诊断), precious-metal-pulse (贵金属脉搏)
  • Resources: skill://trading/logic/technical-analysis, skill://trading/logic/precious-metals-analysis
  • Dynamic Resources: crypto://{symbol}/analysis, pm://{metal}/analysis, fund://{code}/analysis
  • Portfolio: portfolio_add (模拟交易), portfolio_view (盈亏分析), portfolio_chart (盈亏图表), trading_suggest (AI建议)
  • Cache: cache_status (缓存状态), cache_clear (清理缓存)

📋 完整工具列表

点击展开 65 个工具的完整列表

📈 股票 & 市场

工具名 功能说明
search 根据股票名称、公司名称等关键词查找股票代码
stock_info 根据股票代码和市场获取股票基本信息
market_prices 获取市场历史价格及技术指标 (MACD/RSI/KDJ/BOLL)
stock_news 获取指定个股最近新闻动态
stock_news_global 获取最新的全球财经快讯
stock_indicators_a 获取A股财务报告关键指标
stock_indicators_hk 获取港股财务报告关键指标
stock_indicators_us 获取美股财务报告关键指标
institutional_holding_summary 获取个股最新机构持仓与持股比例
stock_zt_pool_em 获取A股所有涨停股票
stock_zt_pool_strong_em 获取A股强势股池数据
stock_lhb_ggtj_sina 获取A股龙虎榜个股上榜统计
stock_sector_fund_flow_rank 获取A股行业资金流向数据
northbound_funds 获取北向资金近10个交易日数据
sector_valuation 获取申万一级行业估值(P/E、P/B)概览
sector_rotation 基于行业资金流与涨跌幅识别短期强势行业
market_anomaly_scan 扫描A股市场实时异动信号 (火箭发射、大笔买入等)
get_current_time 获取当前时间及A股交易日信息

₿ 加密货币

工具名 功能说明
crypto_prices 获取OKX加密货币历史K线数据及技术指标
crypto_sentiment_metrics 获取加密货币情绪指标
okx_funding_rate 获取永续合约资金费率
okx_open_interest 获取永续合约持仓量数据
binance_ai_report 获取币安AI分析报告 (推荐)
fear_greed_index 获取加密货币恐惧贪婪指数 (0-100)
crypto_composite_diagnostic 一键获取加密货币综合诊断数据
draw_crypto_chart 生成加密货币ASCII走势图
backtest_crypto_strategy 加密货币策略回测 (SMA/RSI/MACD)

🥇 贵金属

工具名 功能说明
pm_spot_prices 获取上海金交所现货历史价格及技术指标
pm_international_prices 获取国际贵金属实时价格 (伦敦金/COMEX)
pm_etf_holdings 获取全球黄金/白银ETF持仓量变化
pm_comex_inventory 获取COMEX交易所库存数据
pm_basis 获取贵金属期现基差数据
pm_benchmark_price 获取上海金银基准价格
pm_composite_diagnostic 一键获取贵金属综合诊断数据

💱 外汇

工具名 功能说明
fx_rates 获取主要货币对实时汇率 (USD/EUR/JPY/GBP等)
fx_history 获取指定货币对历史汇率数据

🏗️ 期货

工具名 功能说明
futures_prices 获取国内期货主力合约历史价格及技术指标
futures_inventory 获取期货品种仓单库存数据
futures_basis 获取期货与现货价格基差数据
futures_positions 获取期货主力合约机构持仓排名

🏦 基金

工具名 功能说明
fund_info 获取基金基本信息 (名称/类型/规模/管理人)
fund_nav 获取基金历史净值数据
fund_holdings 获取基金股票持仓明细
fund_ranking 获取基金排行榜 (按类型/收益率筛选)
market_prices 获取ETF基金历史价格数据 (asset=etf)

🌍 宏观经济

工具名 功能说明
macro_gdp 获取中国GDP季度数据
macro_cpi 获取中国CPI月度数据
macro_pmi 获取中国PMI制造业指数
macro_interest_rate 获取LPR贷款市场报价利率
macro_money_supply 获取货币供应量(M0/M1/M2)数据

🧠 分析 & 回测

工具名 功能说明
composite_stock_diagnostic 一键获取个股技术面/基本面/消息面综合诊断
draw_ascii_chart 生成股票ASCII走势图
backtest_strategy 策略回测 (SMA/RSI/MACD/BOLL/MA_CROSS/KDJ)
trading_suggest 基于AI分析给出投资建议

💼 模拟盘 & 系统

工具名 功能说明
portfolio_add 添加模拟持仓记录
portfolio_view 查看模拟盘实时盈亏
portfolio_chart 生成持仓盈亏ASCII柱状图
cache_status 查看缓存状态
cache_clear 清理指定或所有缓存

💡 实战示例

让 AI 帮你分析一只股票，体验 AkTools Pro 的强大：

User: 帮我分析一下 贵州茅台(600519) 的近期走势

Assistant: 好的，正在为您获取 贵州茅台(600519) 的综合数据...

[调用 market_prices, stock_indicators, stock_news...]

📊 **贵州茅台 (600519) 技术面分析**

Price
2100 +                                     |
     |              |                      |
2050 +            | | |                    |
     |          | | | |  |                 |
2000 +        | | | | |  | |               |
     |      | | | | | |  | | |             |
1950 +    | | | | | | |  | | |             +------- 现价: 1985.00
     |  | | | | | | | |  | | |             |
1900 +| | | | | | | | |  | | |             |
     +-------------------------------------+
      10-01   10-15   11-01   11-15   12-01

📈 **诊断结论**:
1. **趋势**: 短期均线(MA5/10)呈多头排列，RSI(14) 为 62.5，处于强势区间。
2. **资金**: 北向资金近3日连续净买入，机构持仓保持稳定。
3. **估值**: 当前 PE(TTM) 为 28.5，处于历史 40% 分位，具备安全边际。

💡 **操作建议**: 持有 (Score: 85)

🆚 版本对比

功能特性 AkTools (原版) AkTools Pro (本版)
项目架构 单文件脚本 📦 模块化工程
回测引擎 ❌ ✅ 支持
模拟持仓 ❌ ✅ 支持
ASCII 图表 ❌ ✅ 支持
SOP 技能库 ❌ ✅ 支持
类型安全 ❌ ✅ 全类型提示

👨‍💻 开发与贡献

# 同步环境
uv sync

# 运行检查
uv run aktools-pro inspect

# 运行测试
uv run pytest tests/ -v

# 代码检查
uv run ruff check mcp_aktools

Built with ❤️ for the Quantitative Trading Community

About

🚀 AkTools Pro: 增强型金融 MCP 服务器。支持 A股/港美股/加密货币/贵金属/外汇/期货/基金/宏观经济数据，内置策略回测、模拟盘管理、ASCII图表，深度适配 Claude Code/OpenCode。

github.com/tchivs/mcp-aktools

Topics

python mcp opencode forex cryptocurrency stock-market futures financial-data quantitative-trading backtesting portfolio-management precious-metals akshare ai-agent mcp-server claude-code

Resources

Readme

License

MIT license
Activity

Stars

3 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 10

v0.5.5 - Performance: Fix MCP Timeout Latest
Feb 2, 2026
+ 9 releases

Packages

 
 
 

Contributors

Languages

  • Python 99.7%
  • Dockerfile 0.3%