{
  "markdown": "<div align=\"center\">\n\n# 📈 AkTools Pro MCP Server\n\n<p align=\"center\">\n  <b>让 AI 成为你的金融分析师</b><br>\n  <i>Empower your AI Agents with Professional Financial Intelligence</i>\n</p>\n\n<p align=\"center\">\n    <a href=\"https://github.com/tchivs/aktools-pro/releases\"><img src=\"https://img.shields.io/github/v/release/tchivs/aktools-pro?color=blue&label=version&style=flat-square\" alt=\"Version\"></a>\n    <a href=\"https://pypi.org/project/aktools-pro/\"><img src=\"https://img.shields.io/pypi/v/aktools-pro?color=green&style=flat-square\" alt=\"PyPI\"></a>\n    <a href=\"https://github.com/tchivs/aktools-pro/blob/main/LICENSE\"><img src=\"https://img.shields.io/github/license/tchivs/aktools-pro?color=orange&style=flat-square\" alt=\"License\"></a>\n    <a href=\"https://www.python.org/\"><img src=\"https://img.shields.io/badge/python-3.10+-blue.svg?style=flat-square\" alt=\"Python\"></a>\n    <a href=\"https://github.com/jlowin/fastmcp\"><img src=\"https://img.shields.io/badge/Powered%20by-FastMCP-blue?style=flat-square\" alt=\"FastMCP\"></a>\n    <a href=\"https://github.com/tchivs/aktools-pro/stargazers\"><img src=\"https://img.shields.io/github/stars/tchivs/aktools-pro?style=flat-square\" alt=\"GitHub stars\"></a>\n</p>\n\n[功能亮点](#-核心特性) • [系统架构](#-系统架构) • [快速开始](#-快速开始) • [工具一览](#-工具一览) • [实战示例](#-实战示例)\n\n</div>\n\n---\n\n<!-- mcp-name: io.github.tchivs/aktools-pro -->\n\n**AkTools Pro** 是一个基于 [akshare](https://github.com/akfamily/akshare) 的增强型 MCP (Model Context Protocol) 服务器。它不仅仅是一个数据接口，更是一个内置了专业金融分析逻辑、交易策略和可视化能力的 AI 技能库。\n\n无论是 A 股、港美股、加密货币还是贵金属，AkTools Pro 都能让你的 AI Agent 像资深分析师一样思考和回答。\n\n## 🌟 核心特性\n\n| 🧠 智能技能引擎 | 💹 全球市场覆盖 |\n| :--- | :--- |\n| 内置 **MCP Prompts** 和 **Resources**，注入 \"分析师\" 人格与 SOP 标准流程。 | 一站式覆盖 **A股、港股、美股、加密货币、贵金属** 等主流投资品种。 |\n| **📊 可视化增强** | **🛡️ 极致性能** |\n| 支持在聊天界面直接绘制 **ASCII 字符走势图**，让数据趋势一目了然。 | 采用 **内存 + 磁盘** 双层缓存机制，毫秒级响应，智能保护数据源。 |\n| **💼 实战模拟** | **🧪 策略实验室** |\n| 内置虚拟持仓管理系统，支持 AI 自动跟踪 **盈亏 (P&L)** 与胜率统计。 | 内置回测引擎，支持验证 **SMA / RSI / MACD / BOLL / KDJ / MA_CROSS** 等经典交易策略。 |\n\n## 🏗 系统架构\n\n```mermaid\ngraph TD\n    User((User / AI Agent)) <-->|MCP Protocol| Server[AkTools Pro Server]\n    \n    subgraph \"Core Engine\"\n        Server --> Skills[Skill Injector]\n        Server --> Cache[Dual-Layer Cache]\n        Server --> Visual[Visual Engine]\n        Server --> Logic[Backtest/Analysis]\n    end\n    \n    subgraph \"Data Sources\"\n        Cache <--> AkShare[AkShare API]\n        Cache <--> OKX[OKX / Binance]\n        Cache <--> News[Financial News]\n    end\n    \n    Skills -->|SOPs & Prompts| User\n    Visual -->|ASCII Charts| User\n```\n\n## 🚀 快速开始\n\n选择最适合你的安装方式，30秒内即可启动。\n\n<details open>\n<summary><strong>📦 方式 1: 自动安装 (推荐)</strong></summary>\n\n在你的 AI 终端中根据客户端类型执行：\n\n#### **OpenCode (Sisyphus)**\n```bash\nopencode mcp add\n# 1. Location: Global\n# 2. Name: aktools-pro\n# 3. Type: Local\n# 4. Command: uvx aktools-pro\n```\n\n#### **Claude Code / OpenAI Codex**\n```bash\nclaude mcp add aktools-pro -- uvx aktools-pro\n```\n\n#### **Cursor / VS Code**\n在 `mcpServers` 配置文件中添加：\n```json\n\"aktools-pro\": {\n  \"command\": \"uvx\",\n  \"args\": [\"aktools-pro\"]\n}\n```\n</details>\n\n<details>\n<summary><strong>🐳 方式 2: Docker 部署</strong></summary>\n\n适合服务器环境或偏好隔离的用户：\n\n```bash\nmkdir /opt/aktools-pro\ncd /opt/aktools-pro\nwget https://raw.githubusercontent.com/tchivs/aktools-pro/main/docker-compose.yml\ndocker-compose up -d\n```\n</details>\n\n<details>\n<summary><strong>⚙️ 环境变量配置</strong></summary>\n\n| 变量名 | 说明 | 默认值 |\n| :--- | :--- | :--- |\n| `OKX_BASE_URL` | OKX 代理地址 | `https://okx.com` |\n| `BINANCE_BASE_URL` | 币安代理地址 | `https://www.binance.com` |\n| `NEWSNOW_BASE_URL` | 资讯接口地址 | `https://newsnow.busiyi.world` |\n| `TRANSPORT` | MCP 协议 | `stdio` |\n\n</details>\n\n## 🛠 工具一览\n\nAkTools Pro 提供了 65 个专业工具，分为以下核心模块：\n\n### 📈 股票 & 市场 (Stock & Market)\n> 覆盖 A股/港股/美股 的行情与基本面\n\n- **基础**: `search` (搜代码), `stock_info` (个股信息)\n- **行情**: `market_prices` (历史K线), `stock_zt_pool_em` (涨停池)\n- **数据**: `stock_indicators` (财务指标), `stock_lhb` (龙虎榜), `northbound_funds` (北向资金)\n- **分析**: `sector_valuation` (行业估值), `sector_rotation` (板块轮动), `market_anomaly_scan` (异动扫描)\n\n### ₿ 加密货币 (Crypto)\n> 接入 OKX/Binance 的深度数据\n\n- **行情**: `crypto_prices` (K线), `draw_crypto_chart` (字符图)\n- **情绪**: `fear_greed_index` (恐贪指数), `crypto_sentiment_metrics` (情绪指标)\n- **衍生品**: `okx_funding_rate` (资金费率), `okx_open_interest` (持仓量)\n- **智能**: `binance_ai_report` (AI研报), `crypto_composite_diagnostic` (综合诊断)\n\n### 🥇 贵金属 (Precious Metals)\n> 黄金/白银的期现货数据\n\n- **价格**: `pm_spot_prices` (现货), `pm_international_prices` (外盘)\n- **库存**: `pm_etf_holdings` (ETF持仓), `pm_comex_inventory` (COMEX库存)\n- **分析**: `pm_basis` (期现基差), `pm_composite_diagnostic` (综合诊断)\n\n### 💱 外汇 (Forex)\n> 全球汇率行情与历史数据\n\n- **行情**: `fx_rates` (即期汇率/交叉汇率)\n- **历史**: `fx_history` (历史汇率)\n\n### 🏗️ 期货 (Futures)\n> 商品与金融期货深度数据\n\n- **行情**: `futures_prices` (K线数据)\n- **库存**: `futures_inventory` (交易所库存)\n- **基差**: `futures_basis` (期现基差)\n- **持仓**: `futures_positions` (仓单日报)\n\n### 🏦 基金 (Funds)\n> 公募基金与 ETF 数据\n\n- **基础**: `fund_info` (基本信息), `fund_ranking` (基金排行)\n- **业绩**: `fund_nav` (净值走势)\n- **持仓**: `fund_holdings` (重仓股)\n- **ETF**: `market_prices` (asset=etf)\n\n### 🌍 宏观经济 (Macro)\n> 全球与中国宏观经济指标\n\n- **核心**: `macro_gdp` (国内生产总值), `macro_cpi` (消费者物价指数)\n- **景气**: `macro_pmi` (采购经理指数)\n- **金融**: `macro_interest_rate` (基准利率), `macro_money_supply` (货币供应量)\n\n### 🧠 智能技能 (AI Skills)\n> 让 AI 具备专业分析师的思维\n\n- **股票 Prompts**: `analyze-stock` (个股诊断), `market-pulse` (市场脉搏)\n- **加密 Prompts**: `analyze-crypto` (币种分析), `crypto-pulse` (币圈脉搏)\n- **贵金属 Prompts**: `analyze-precious-metal` (贵金属诊断), `precious-metal-pulse` (贵金属脉搏)\n- **Resources**: `skill://trading/logic/technical-analysis`, `skill://trading/logic/precious-metals-analysis`\n- **Dynamic Resources**: `crypto://{symbol}/analysis`, `pm://{metal}/analysis`, `fund://{code}/analysis`\n- **Portfolio**: `portfolio_add` (模拟交易), `portfolio_view` (盈亏分析), `portfolio_chart` (盈亏图表), `trading_suggest` (AI建议)\n- **Cache**: `cache_status` (缓存状态), `cache_clear` (清理缓存)\n\n\n## 📋 完整工具列表\n\n<details>\n<summary><strong>点击展开 65 个工具的完整列表</strong></summary>\n\n### 📈 股票 & 市场\n\n| 工具名 | 功能说明 |\n|--------|----------|\n| `search` | 根据股票名称、公司名称等关键词查找股票代码 |\n| `stock_info` | 根据股票代码和市场获取股票基本信息 |\n| `market_prices` | 获取市场历史价格及技术指标 (MACD/RSI/KDJ/BOLL) |\n| `stock_news` | 获取指定个股最近新闻动态 |\n| `stock_news_global` | 获取最新的全球财经快讯 |\n| `stock_indicators_a` | 获取A股财务报告关键指标 |\n| `stock_indicators_hk` | 获取港股财务报告关键指标 |\n| `stock_indicators_us` | 获取美股财务报告关键指标 |\n| `institutional_holding_summary` | 获取个股最新机构持仓与持股比例 |\n| `stock_zt_pool_em` | 获取A股所有涨停股票 |\n| `stock_zt_pool_strong_em` | 获取A股强势股池数据 |\n| `stock_lhb_ggtj_sina` | 获取A股龙虎榜个股上榜统计 |\n| `stock_sector_fund_flow_rank` | 获取A股行业资金流向数据 |\n| `northbound_funds` | 获取北向资金近10个交易日数据 |\n| `sector_valuation` | 获取申万一级行业估值(P/E、P/B)概览 |\n| `sector_rotation` | 基于行业资金流与涨跌幅识别短期强势行业 |\n| `market_anomaly_scan` | 扫描A股市场实时异动信号 (火箭发射、大笔买入等) |\n| `get_current_time` | 获取当前时间及A股交易日信息 |\n\n### ₿ 加密货币\n\n| 工具名 | 功能说明 |\n|--------|----------|\n| `crypto_prices` | 获取OKX加密货币历史K线数据及技术指标 |\n| `crypto_sentiment_metrics` | 获取加密货币情绪指标 |\n| `okx_funding_rate` | 获取永续合约资金费率 |\n| `okx_open_interest` | 获取永续合约持仓量数据 |\n| `binance_ai_report` | 获取币安AI分析报告 (推荐) |\n| `fear_greed_index` | 获取加密货币恐惧贪婪指数 (0-100) |\n| `crypto_composite_diagnostic` | 一键获取加密货币综合诊断数据 |\n| `draw_crypto_chart` | 生成加密货币ASCII走势图 |\n| `backtest_crypto_strategy` | 加密货币策略回测 (SMA/RSI/MACD) |\n\n### 🥇 贵金属\n\n| 工具名 | 功能说明 |\n|--------|----------|\n| `pm_spot_prices` | 获取上海金交所现货历史价格及技术指标 |\n| `pm_international_prices` | 获取国际贵金属实时价格 (伦敦金/COMEX) |\n| `pm_etf_holdings` | 获取全球黄金/白银ETF持仓量变化 |\n| `pm_comex_inventory` | 获取COMEX交易所库存数据 |\n| `pm_basis` | 获取贵金属期现基差数据 |\n| `pm_benchmark_price` | 获取上海金银基准价格 |\n| `pm_composite_diagnostic` | 一键获取贵金属综合诊断数据 |\n\n### 💱 外汇\n\n| 工具名 | 功能说明 |\n|--------|----------|\n| `fx_rates` | 获取主要货币对实时汇率 (USD/EUR/JPY/GBP等) |\n| `fx_history` | 获取指定货币对历史汇率数据 |\n\n### 🏗️ 期货\n\n| 工具名 | 功能说明 |\n|--------|----------|\n| `futures_prices` | 获取国内期货主力合约历史价格及技术指标 |\n| `futures_inventory` | 获取期货品种仓单库存数据 |\n| `futures_basis` | 获取期货与现货价格基差数据 |\n| `futures_positions` | 获取期货主力合约机构持仓排名 |\n\n### 🏦 基金\n\n| 工具名 | 功能说明 |\n|--------|----------|\n| `fund_info` | 获取基金基本信息 (名称/类型/规模/管理人) |\n| `fund_nav` | 获取基金历史净值数据 |\n| `fund_holdings` | 获取基金股票持仓明细 |\n| `fund_ranking` | 获取基金排行榜 (按类型/收益率筛选) |\n| `market_prices` | 获取ETF基金历史价格数据 (asset=etf) |\n\n### 🌍 宏观经济\n\n| 工具名 | 功能说明 |\n|--------|----------|\n| `macro_gdp` | 获取中国GDP季度数据 |\n| `macro_cpi` | 获取中国CPI月度数据 |\n| `macro_pmi` | 获取中国PMI制造业指数 |\n| `macro_interest_rate` | 获取LPR贷款市场报价利率 |\n| `macro_money_supply` | 获取货币供应量(M0/M1/M2)数据 |\n\n### 🧠 分析 & 回测\n\n| 工具名 | 功能说明 |\n|--------|----------|\n| `composite_stock_diagnostic` | 一键获取个股技术面/基本面/消息面综合诊断 |\n| `draw_ascii_chart` | 生成股票ASCII走势图 |\n| `backtest_strategy` | 策略回测 (SMA/RSI/MACD/BOLL/MA_CROSS/KDJ) |\n| `trading_suggest` | 基于AI分析给出投资建议 |\n\n### 💼 模拟盘 & 系统\n\n| 工具名 | 功能说明 |\n|--------|----------|\n| `portfolio_add` | 添加模拟持仓记录 |\n| `portfolio_view` | 查看模拟盘实时盈亏 |\n| `portfolio_chart` | 生成持仓盈亏ASCII柱状图 |\n| `cache_status` | 查看缓存状态 |\n| `cache_clear` | 清理指定或所有缓存 |\n\n</details>\n\n## 💡 实战示例\n\n让 AI 帮你分析一只股票，体验 **AkTools Pro** 的强大：\n\n````text\nUser: 帮我分析一下 贵州茅台(600519) 的近期走势\n\nAssistant: 好的，正在为您获取 贵州茅台(600519) 的综合数据...\n\n[调用 market_prices, stock_indicators, stock_news...]\n\n📊 **贵州茅台 (600519) 技术面分析**\n\nPrice\n2100 +                                     |\n     |              |                      |\n2050 +            | | |                    |\n     |          | | | |  |                 |\n2000 +        | | | | |  | |               |\n     |      | | | | | |  | | |             |\n1950 +    | | | | | | |  | | |             +------- 现价: 1985.00\n     |  | | | | | | | |  | | |             |\n1900 +| | | | | | | | |  | | |             |\n     +-------------------------------------+\n      10-01   10-15   11-01   11-15   12-01\n\n📈 **诊断结论**:\n1. **趋势**: 短期均线(MA5/10)呈多头排列，RSI(14) 为 62.5，处于强势区间。\n2. **资金**: 北向资金近3日连续净买入，机构持仓保持稳定。\n3. **估值**: 当前 PE(TTM) 为 28.5，处于历史 40% 分位，具备安全边际。\n\n💡 **操作建议**: 持有 (Score: 85)\n````\n\n## 🆚 版本对比\n\n| 功能特性 | AkTools (原版) | AkTools Pro (本版) |\n| :--- | :---: | :---: |\n| **项目架构** | 单文件脚本 | 📦 **模块化工程** |\n| **回测引擎** | ❌ | ✅ **支持** |\n| **模拟持仓** | ❌ | ✅ **支持** |\n| **ASCII 图表** | ❌ | ✅ **支持** |\n| **SOP 技能库** | ❌ | ✅ **支持** |\n| **类型安全** | ❌ | ✅ **全类型提示** |\n\n## 👨‍💻 开发与贡献\n\n```bash\n# 同步环境\nuv sync\n\n# 运行检查\nuv run aktools-pro inspect\n\n# 运行测试\nuv run pytest tests/ -v\n\n# 代码检查\nuv run ruff check mcp_aktools\n```\n\n<div align=\"center\">\n    <br>\n    <p>Built with ❤️ for the Quantitative Trading Community</p>\n</div>\n",
  "bytes": 10276,
  "sha": "e667a2378fb53cbb1120742295df13c00ef11ba82e381f69333282643f2d2df3",
  "repo_slug": "tchivs/mcp-aktools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tchivs_aktools_pro_64b50491/readme"
}