AKShare One MCP Server

AKShare One MCP サーバー

概要

akshare-one をベースにした MCP サーバーです。中国株式市場データ向けの包括的なインターフェースを提供します。過去の株価データ、リアルタイムデータ、ニュースデータ、財務諸表などの金融情報を取得するための強力なツールを備えています。

利用可能なツール

データソースの自動フォールバック

上流で単一のデータソースのみが公開されている get_inner_trade_data を除き、各データツールには優先するデータソースを指定する source パラメーターと、選択したデータソースが例外を発生させる、または空のデータフレームを返す場合に同じドメインの他のデータソースを試すかどうかを決める fallback パラメーター（デフォルトで有効）があります。

ドメイン	試行順
過去データ	eastmoney → eastmoney_direct → sina → ths
リアルタイム	eastmoney_direct → eastmoney → xueqiu → ths（銘柄が指定されていない場合、最後の2つはスキップされます）
ニュース	eastmoney → ths
財務諸表	sina ⇄ eastmoney_direct

指定された source は常に最初に試されます。上記の順序はフォールバック時にのみ適用されます。akshare-one は各データソースの出力をドメインで定義された列に変換するため、フォールバックによってフィールド名や順序が変わることはありません。すべてのデータソースでエラーが発生した場合は、それぞれのエラー内容を一覧にしたエラーが返されます。すべてのデータソースで処理が成功してもデータがない場合は、空の結果が返されます。単一のデータソースに固定するには、fallback を false に設定してください。そのデータソースでエラーが発生すると、そのエラーが直接表示されるため、数値の出所を正確に確認したい場合に便利です。

実際に呼び出しに応答したデータソースは、akshare_one_mcp.providers ロガーに記録されます。

市場データツール

get_hist_data

複数の期間と調整方法に対応した、過去の株式市場データを取得します。

パラメーター

• symbol（string、必須）：銘柄コード（例：'000001'）
• interval（string、任意）：時間間隔（'minute'、'hour'、'day'、'week'、'month'、'year'）（デフォルト：'day'）
• interval_multiplier（number、任意）：時間間隔の倍率（デフォルト：1）
• start_date（string、任意）：YYYY-MM-DD 形式の開始日（デフォルト：'1970-01-01'）
• end_date（string、任意）：YYYY-MM-DD 形式の終了日（デフォルト：'2030-12-31'）
• adjust（string、任意）：調整方法（'none'、'qfq'、'hfq'）（デフォルト：'none'）
• source（string、任意）：データソース（'eastmoney'、'eastmoney_direct'、'sina'、'ths'）（デフォルト：'eastmoney'）
• fallback（boolean、任意）：選択したデータソースでエラーが発生する、またはデータがない場合、'eastmoney'、'eastmoney_direct'、'sina'、'ths' の順に試します（デフォルト：true）
• indicators_list（list、任意）：追加するテクニカル指標
• recent_n（number、任意）：返す直近のレコード数（デフォルト：100）

#### `get_realtime_data` リアルタイムの株式市場データを取得します。

パラメーター

• symbol (string, optional): 株式コード
• source (string, optional): データソース（'eastmoney_direct'、'eastmoney'、'xueqiu'、'ths'）（デフォルト：'eastmoney_direct'）
• fallback (boolean, optional): 選択したソースでエラーが発生した場合、またはデータがない場合に、'eastmoney_direct'、'eastmoney'、'xueqiu'、'ths' の順に試します（デフォルト：true。'xueqiu' と 'ths' は一度に1つの銘柄を扱うため、銘柄が指定されていない場合はスキップされます）

ニュース・情報ツール

get_news_data

株式関連のニュースデータを取得します。

パラメーター

• symbol (string, required): 株式コード
• source (string, optional): データソース（'eastmoney'、'ths'）（デフォルト：'eastmoney'）
• fallback (boolean, optional): 選択したソースでエラーが発生した場合、またはデータがない場合に、'eastmoney' と 'ths' を順に試します（デフォルト：true）
• recent_n (number, optional): 返す最新のレコード数。新しい順に返します（デフォルト：10）

財務諸表ツール

get_balance_sheet

企業の貸借対照表データを取得します。

パラメーター

• symbol (string, required): 株式コード
• source (string, optional): データソース（'sina'、'eastmoney_direct'）（デフォルト：'sina'）
• fallback (boolean, optional): 選択したソースでエラーが発生した場合、またはデータがない場合に、もう一方のソースを試します（デフォルト：true）
• recent_n (number, optional): 返す最新のレコード数。新しい順に返します（デフォルト：10）

get_income_statement

企業の損益計算書データを取得します。

パラメーター

• symbol (string, required): 株式コード
• source (string, optional): データソース（'sina'、'eastmoney_direct'）（デフォルト：'sina'）
• fallback (boolean, optional): 選択したソースでエラーが発生した場合、またはデータがない場合に、もう一方のソースを試します（デフォルト：true）
• recent_n (number, optional): 返す最新のレコード数。新しい順に返します（デフォルト：10）

get_cash_flow

企業のキャッシュフロー計算書データを取得します。

パラメーター

• symbol (string, required): 株式コード
• source (string, optional): データソース（'sina'、'eastmoney_direct'）（デフォルト：'sina'）
• fallback (boolean, optional): 選択したソースでエラーが発生した場合、またはデータがない場合に、もう一方のソースを試します（デフォルト：true）
• recent_n (number, optional): 返す最新のレコード数。新しい順に返します（デフォルト：10）

分析・指標ツール

get_inner_trade_data

企業のインサイダー取引データを取得します。

パラメーター

• symbol (string, required): 株式コード

get_financial_metrics

主要な3つの財務諸表から重要な財務指標を取得します。

パラメーター

• symbol (string, required): 株式コード
• source (string, optional): データソース（'sina'、'eastmoney_direct'）（デフォルト：'eastmoney_direct'）
• fallback (boolean, optional): 選択したソースでエラーが発生した場合、またはデータがない場合に、もう一方のソースを試します（デフォルト：true）
• recent_n (number, optional): 返す最新のレコード数。新しい順に返します（デフォルト：10）

get_time_info

ISO形式の現在時刻、タイムスタンプ、直近の取引日を取得します。

インストールとセットアップ

実行モード

サーバーはstdioとstreamable-httpの2つのモードに対応しています。

コマンドライン引数：

• --streamable-http: HTTPモードを有効にします（デフォルト：stdioモード）
• --host: HTTPモードでバインドするホスト（デフォルト：0.0.0.0）
• --port: HTTPモードでリッスンするポート（デフォルト：8081）

注： streamable-httpモードを使用すると、MCP サーバーは http://{host}:{port}/mcp で利用できます。デフォルト設定の場合は、http://0.0.0.0:8081/mcp になります。

インストール方法

方法1：Smithery経由

Smithery 経由で akshare-one-mcp を Claude Desktop に自動インストールするには：

npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude

オプション 2：uv 経由

まだインストールしていない場合は、uv をインストールしてください。

uvx は PyPI からパッケージをインストールし、Python 3.12 以降で実行します。

MCP クライアントの設定に、次の構成を追加してください。

{
  "mcpServers": {
    "akshare-one-mcp": {
      "command": "uvx",
      "args": ["akshare-one-mcp"]
    }
  }
}

オプション 3：ローカル開発環境のセットアップ

1. このリポジトリをクローンします。

   git clone https://github.com/zwldarren/akshare-one-mcp.git
   cd akshare-one-mcp
   

2. 依存関係をインストールします。

   uv sync
   

3. MCP クライアントの設定に、次の構成を追加してください。

   {
     "mcpServers": {
       "akshare-one-mcp": {
         "command": "uv",
         "args": [
           "--directory",
           "/path/to/akshare-one-mcp",
           "run",
           "akshare-one-mcp"
         ]
       }
     }
   }
   

テクニカル指標リファレンス

get_hist_data ツールは、次のテクニカル指標に対応しています。

トレンド指標

• 移動平均：SMA（単純移動平均）、EMA（指数移動平均）
• トレンド追跡：MACD（移動平均収束拡散法）、APO（絶対価格オシレーター）、PPO（パーセンテージ価格オシレーター）
• 変化率：ROC（変化率）、ROCP（変化率パーセンテージ）、ROCR（変化率比率）、ROCR100
• その他：TRIX（三重指数移動平均）、ULTOSC（アルティメットオシレーター）

モメンタム指標

• 相対的な強さ：RSI（相対力指数）、CCI（商品チャネル指数）
• トレンドの強さ：ADX（平均方向性指数）、DX（方向性指数）
• マネーフロー：MFI（マネーフロー指数）、MOM（モメンタム）、CMO（チャンデ・モメンタム・オシレーター）、WILLR（ウィリアムズ %R）

ボラティリティ指標

• ボリンジャーバンド：BOLL（ボリンジャーバンド）
• 平均真の値幅：ATR（平均真の値幅）
• パラボリック SAR：SAR（パラボリック・ストップ・アンド・リバース）

出来高指標

• 出来高：OBV（オンバランス出来高）、AD（蓄積・分配ライン）、ADOSC（蓄積・分配オシレーター）

その他の指標

• ストキャスティクス：STOCH（ストキャスティクス・オシレーター）
• アルーン：AROON（アルーン指標）、AROONOSC（アルーン・オシレーター）
• 勢力均衡：BOP（勢力均衡）
• 方向性指標：MINUS_DI、MINUS_DM、PLUS_DI、PLUS_DM
• 時系列予測：TSF（時系列予測）