Finq4cn MCP Server

🚀 FinQ4Cn MCP サーバ

FinQ4Cn-mcp-serverは、定量分析に特化した専用MCPサーバツールです。中国のA股市場に対して、簡便で無料かつオープンソースの金融データアクセスを提供することを目的としています。このプロジェクトはakshareライブラリに基づいて構築され、中国のA股市場に焦点を当て、ユーザーに全面的な株式および関連金融商品のデータサポートを提供します。定量分析を行う専門家や、中国国内の株式市場に興味があるユーザーに最適で、中国金融市場のデータニーズを満たすことができます。国内市場の投資家向けに設計された理想的なツールとして、FinQ4Cn-mcp-serverは、株式名とコードの取得、株価の歴史的データ分析、財務概要データの照会、信用取引の明細データなどの核心的な機能を提供します。

🚀 クイックスタート

FinQ4Cn-mcp-serverは、中国のA股市場の金融データにアクセスするための便利なツールです。以下の手順に従って、サーバをセットアップして使用してください。

✨ 主な機能

株式リスク警報

• 株式名とコードの取得
• 株価の歴史的データ照会
• 財務概要データの分析
• 信用取引の明細データの閲覧

一般的な指標データ

• 最新の財務ニュースの取得
• 個別株式に関連するニュースの照会

バックテストシステム

• 戦略一：ユーザーの保有比率と利確条件に基づく歴史的データ分析のバックテスト結果。

📦 インストール

依存関係

• FastMCP：高速MCPプロトコルのサポート。
• Pydantic：データ検証とシリアライゼーションに使用。
• akshare：豊富な中国金融市場データを提供。

インストールコマンド：

pip install fastmcp pydantic akshare

セットアップ手順

1. リポジトリをクローンします：

   git clone https://github.com/your-repository-url/FinQ4Cn-MCP-Server.git
   cd FinQ4Cn-MCP-Server
   

2. 仮想環境を作成し、依存関係をインストールします：

   python -m venv env
   source env/bin/activate  # Windowsでは `env\Scripts\activate` を使用
   pip install -r requirements.txt
   

3. プログラムを実行します：

   python app.py
   

💻 使用例

基本的な使用法

if __name__ == "__main__":
    from finq4cn.stocks_common_metrics import StocksCommonMetrics
    
    # StocksCommonMetrics インスタンスを作成
    stockutils = StocksCommonMetrics()
    
    # 株式名と株式コードを取得
    stock_codes = stockutils.get_stock_code(name="华泰证券")
    
    if stock_codes:
        for item in stock_codes:
            stock_code = item['stock_code']
            print(f"処理する株式コード：{stock_code}")
            
            # 株価の歴史的データを取得
            historical_data = stockutils.get_historical_stockprice_data(
                stock_code=stock_code, 
                start_date="20230101", 
                end_date="20231001"
            )
            print("株価の歴史的データ：", historical_data)
            
            # 財務概要データを取得
            financial_summary = stockutils.get_stock_financial_abstract(
                stock_code=stock_code, 
                indicator='按报告期'
            )
            print("財務概要データ：", financial_summary)
            
            # 信用取引の明細データを取得
            margin_detail = stockutils.get_stock_margin_detail(
                stock_code=stock_code, 
                start_date="20230102", 
                end_date="20230110"
            )
            print("信用取引の明細データ：", margin_detail)

📚 ドキュメント

未来計画

このプロジェクトでは、以下の機能を段階的に実装していく予定です。

1. 株式データの充実：より多くの株式の詳細情報とデータサポートを追加。
2. 技術分析サポート：K線図の描画、移動平均線（MA）、相対力指数（RSI）などの一般的な技術指標分析ツールを提供。
3. リスク警報システム：歴史的データ分析に基づくリスク評価モデルを開発。
4. ユーザーカスタマイズ戦略：ユーザーが必要に応じてカスタムの取引戦略を設定できるようにする。

プロジェクト構造

FinQ4Cn-MCP-Server/
├── README.md                 # プロジェクト説明ドキュメント
├── LICENSE                  # ライセンスファイル
├── requirements.txt        # 依存関係管理
├── app.py                   # メインプログラムエントリー
└── finq4cn/                # 核心機能モジュール
    ├── stocks_common_metrics.py   # 株式の一般的な指標データ処理
    └── news_report.py              # ニュースデータ取得モジュール

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

👏 謝辞

• FastMCPを使用して構築。
• akshareに依存して全面的な金融データサポートを取得。
• Pydanticを使用してデータ検証を行う。