aktools-pro
馃殌 AkTools Pro: 澧炲己鍨嬮噾铻� MCP 鏈嶅姟鍣ㄣ�傚唴缃瓥鐣ュ洖娴嬨�佹ā鎷熺洏绠$悊鍙婂疄鏃跺紓鍔ㄧ洃鎺с��
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"aktools-pro": {
"args": [
"aktools-pro@0.2.2"
],
"command": "uvx"
},
"ghcr.io/tchivs/aktools-pro": {
"args": [
"run",
"-i",
"--rm",
"ghcr.io/tchivs/aktools-pro:latest"
],
"command": "docker"
}
}
}
可用工具 (5 个)
该服务在 MCP 协议中暴露的工具,AI 可按需调用
tavily_search 14 个参数 需填 1 项
Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.
必填参数:query
tavily_extract 6 个参数 需填 1 项
Extract content from URLs. Returns raw page content in markdown or text format.
必填参数:urls
tavily_crawl 11 个参数 需填 1 项
Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.
必填参数:url
tavily_map 8 个参数 需填 1 项
Map a website's structure. Returns a list of URLs found starting from the base URL.
必填参数:url
tavily_research 2 个参数 需填 1 项
Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.
必填参数:input
服务介绍
📈 AkTools Pro MCP Server
[功能亮点](# -核心特性) • [系统架构](# -系统架构) • [快速开始](# -快速开始) • [工具一览](# -工具一览) • [实战示例](# -实战示例)
<!- - mcp-name: io.github.tchivs/aktools-pro - ->
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
# 🚀 快速开始
选择最适合你的安装方式,30秒内即可启动。
在你的 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"]
}
适合服务器环境或偏好隔离的用户:
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(清理缓存)
# 📋 完整工具列表
# # 📈 股票 & 市场
| 工具名 | 功能说明 |
|- -- -- -- -|- -- -- -- -- -|
| 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