aktools-pro 0.3.0

MCP Server for stock and crypto

📈 AkTools Pro MCP Server

基于 akshare 的增强型 MCP (Model Context Protocol) 服务器，为 AI Agent 提供专业的金融数据查询、深度分析及实战交易技能。

🌟 核心亮点

• 🧠 不仅是工具，更是技能: 支持 MCP Prompts 和 Resources，内置金融分析 SOP。
• 💹 全市场覆盖: A股、港股、美股、加密货币数据一站式获取。
• 📊 可视化增强: 支持 ASCII 字符走势图，让 AI 的分析更直观。
• 🛡️ 双层缓存: 内存 + 磁盘双层缓存机制，极致响应速度，保护数据源。
• 💼 实战模拟: 内置模拟持仓管理，支持 AI 自动跟踪盈亏。
• 🧪 策略回测: 内置极简回测引擎，支持验证均线、RSI、MACD 等交易策略。

---

💎 AkTools Pro vs 原版区别 (Why Pro?)

本项目 fork 自 aahl/mcp-aktools，并在其基础上进行了深度的工程化重构与功能增强。主要区别如下：

维度	AkTools (原版)	AkTools Pro (本版本)
项目架构	单文件 (__init__.py > 900行)	标准模块化包结构，易于扩展和维护
回测能力	❌ 无	✅ 内置 Backtesting 引擎，支持 SMA/RSI/MACD 策略验证
实战功能	❌ 无	✅ 模拟盘持仓管理 (portfolio_add/view)，实时跟踪胜率
视觉增强	❌ 仅限纯文本/CSV	✅ ASCII 字符趋势图 (draw_ascii_chart)，分析更直观
市场雷达	❌ 基础行情抓取	✅ 实时异动监控 (火箭发射/封板等) 与 北向资金 追踪
Agent 支持	基础 Tool 调用	✅ 全功能技能引擎：内置 Prompts、Resources 与 AGENTS.md SOP
工程质量	基础实现	✅ 严格类型提示、Ruff 规范检查与自动缓存机制

---

🚀 快速开始 (aktools-pro)

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

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

OpenCode (Sisyphus)

直接运行交互式命令：

opencode mcp add

按照提示进行操作：

1. Location: 选择 Global
2. Name: 输入 aktools-pro
3. Type: 选择 Local
4. Command: 输入 uvx --from git+https://github.com/tchivs/mcp-aktools.git aktools-pro

Claude Code / OpenAI Codex

# Claude Code
claude mcp add aktools-pro -- uvx --from git+https://github.com/tchivs/mcp-aktools.git aktools-pro

# OpenAI Codex (或其他支持 CLI 安装的客户端)
codex mcp add aktools-pro -- uvx --from git+https://github.com/tchivs/mcp-aktools.git aktools-pro

Cursor / VS Code / Cherry Studio

• Cursor: 手动在 mcpServers 配置中添加以下 JSON，或 点击一键安装
• VS Code:
• Cherry Studio:

"aktools-pro": {
  "command": "uvx",
  "args": ["--from", "git+https://github.com/tchivs/mcp-aktools.git", "aktools-pro"]
}

方式 2: Docker

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

⚙️ 环境变量配置 (Optional)

无论通过 uvx 还是 Docker 安装，均支持以下环境变量：

变量名	说明	默认值 / 示例
OKX_BASE_URL	OKX 代理地址 (避开网络限制)	https://okx.com
BINANCE_BASE_URL	币安代理地址	https://www.binance.com
NEWSNOW_BASE_URL	财经资讯接口地址	https://newsnow.busiyi.world
NEWSNOW_CHANNELS	资讯频道 (逗号分隔)	wallstreetcn-quick,cls-telegraph,jin10
PORT	HTTP 模式下的监听端口	80
TRANSPORT	MCP 传输协议类型	stdio (可选 http, sse)

方式 3: Smithery (即将支持)

敬请期待专属 AkTools Pro 的 Smithery 快速集成。

---

🧠 高级技能 (Advanced Skills)

本项目为 OpenCode / Claude Code 注入了深度金融分析技能：

1. 提示词工作流 (Prompts)

• analyze-stock: 触发资深分析师人格，对个股进行技术面+基本面+消息面的全方位诊断。
• market-pulse: 研判大盘脉搏，分析涨停家数与板块资金流向。
• analyze-crypto: 触发加密货币分析师人格，对币种进行技术面+情绪面的深度分析。
• crypto-pulse: 研判币圈脉搏，分析恐惧贪婪指数、资金费率与持仓量。

2. 知识库资源 (Resources)

• skill://trading/logic/technical-analysis: 内置 MACD、RSI、布林带等指标的专业解读标准。
• skill://trading/strategy/risk-management: 内置仓位管理与止损风险控制准则。
• skill://crypto/logic/analysis-sop: 内置加密货币分析 SOP（多空比、资金费率、RSI 阈值解读）。

3. 复合工具 (Composite Tools)

• composite_stock_diagnostic: 一键获取聚合后的诊断报告。
• draw_ascii_chart: 在聊天框中直接生成价格趋势字符图。
• market_anomaly_scan: 实时扫描“火箭发射”、“大笔买入”等市场异动。
• backtest_strategy: 基于历史数据验证交易策略（SMA/RSI/MACD）。
• sector_valuation / sector_rotation: 研判行业估值水平与资金轮动方向。
• northbound_funds: 跟踪北向资金（聪明钱）的每日流入流出。
• institutional_holding_summary: 汇总个股的机构持仓深度信息。

---

🛠️ 常用工具列表

📈 股票 & 市场

• search: 关键词查找代码
• stock_info: 基本信息
• stock_prices: 历史价格 (含技术指标)
• stock_indicators_a/hk/us: 财务关键指标
• stock_zt_pool_em: 涨停股池
• stock_lhb_ggtj_sina: 龙虎榜统计

₿ 加密货币

• okx_prices: K线数据 (含技术指标)
• okx_loan_ratios: 杠杆多空比
• okx_taker_volume: 主动买卖量
• okx_funding_rate: 永续合约资金费率
• okx_open_interest: 合约持仓量
• fear_greed_index: 市场恐惧贪婪指数
• binance_ai_report: 币安 AI 深度报告
• crypto_composite_diagnostic: 一键综合诊断
• draw_crypto_chart: ASCII 走势图
• backtest_crypto_strategy: 策略回测

💼 模拟实战

• portfolio_add: 加入模拟持仓
• portfolio_view: 查看实时盈亏
• trading_suggest: AI 投资建议

---

👨‍💻 开发与贡献

本项目遵循 AGENTS.md 中的 OpenCode / Sisyphus 开发规范。

# 同步环境
uv sync

# 本地运行 (stdio)
uv run aktools-pro

# 检查技能注册情况
uv run aktools-pro inspect

---

Built with ❤️ for the Quantitative Trading Community