AkTools Pro MCP Server

AkTools Pro は、akshare を基盤とする拡張型 MCP（Model Context Protocol）サーバーです。単なるデータインターフェースではなく、専門的な金融分析ロジック、取引戦略、可視化機能を組み込んだ AI スキルライブラリです。

中国 A 株、香港株、米国株、暗号資産、貴金属のいずれであっても、AkTools Pro を使えば AI エージェントが経験豊富なアナリストのように考え、回答できます。

🌟 コア機能

🏗 システムアーキテクチャ

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 秒以内に起動できます。

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

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

"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

🛠 ツール一覧

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 (清理缓存)

📋 完整工具列表

💡 実践例

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)

🆚 バージョン比較

👨‍💻 開発と貢献

# 同步环境
uv sync

# 运行检查
uv run aktools-pro inspect

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

# 代码检查
uv run ruff check mcp_aktools