Xtquant AI

🚀 xtquantai

xtquantaiは、モデルコンテキストプロトコル（MCP）に基づくサーバーです。迅投（xtquant）の定量取引プラットフォームの機能と人工知能アシスタントを統合し、AIが定量取引データと機能に直接アクセスし操作できるようにします。

🚀 クイックスタート

xtquantaiは、定量取引データと機能へのAIの直接アクセスと操作を可能にする革新的なサーバーです。以下のセクションでは、その機能、インストール方法、使用方法などを詳しく説明します。

✨ 主な機能

XTQuantAIは以下の主要機能を提供しています（順次更新予定です。新しいアイデアの投稿を歓迎します）：

基礎データ照会

• 取引日の取得 (get_trading_dates) - 指定された市場の取引日を取得します。
• セクターの株式リストの取得 (get_stock_list) - 特定のセクターの株式リストを取得します。
• 株式詳細情報の取得 (get_instrument_detail) - 株式の詳細情報を取得します。

相場データ

• 過去の相場データの取得 (get_history_market_data) - 株式の過去の相場データを取得します。
• リアルタイム相場データの取得 (get_realtime_market_data) - 株式のリアルタイム相場データを取得します。
• 相場更新の購読 (subscribe_market_updates) - リアルタイムの相場更新を購読して受信します。

グラフと可視化

• 価格グラフの生成 (generate_price_chart) - 期間とパラメータを指定することで、指定された株式の価格グラフを生成します。
• テクニカル指標分析 (technical_indicator_analysis) - 株式のテクニカル指標（移動平均線、相対力指数など）を計算して返します。

📦 インストール

前提条件

• Python 3.11 以上
• QMTまたは投研端末のインストール
• uv パッケージ管理ツールのインストール

ダウンロードとインストール

git clone https://github.com/your-repository/xtquantai.git
cd xtquantai
pip install -r requirements.txt

💻 使用例

基本的な使用法

CursorでのMCPサーバーの統合（Windows環境のみ）

方法一：main.pyを通じて起動

プロジェクトのルートディレクトリで以下のコマンドを実行します：

python main.py

方法二：Pythonスクリプトを直接実行

server_direct.pyファイルを実行します：

python server_direct.py

ツールの使用例

取引日の取得

from xtquantai import get_trading_dates

dates = get_trading_dates(start_date="2023-01-01", end_date="2023-12-31")
print(dates)

セクターの株式リストの取得

from xtquantai import get_stock_list_by_sector

sector_stocks = get_stock_list_by_sector(sector_id="Technology")
print(sector_stocks)

価格グラフの生成

from xtquantai import generate_price_chart

generate_price_chart(stock_code="AAPL", start_date="2023-01-01", end_date="2023-12-31", save_path="chart.png")

📚 ドキュメント

サーバーの起動

python src/xtquantai/server.py

MCP Inspectorを使用したデバッグ（開発用のみ）

Node.js環境をインストールした後、以下のコマンドを実行します：

npx @modelcontextprotocol/inspector uv run xtquantai

ビルドと公開

1. 依存関係を同期し、ロックファイルを更新します：

   uv sync
   

2. パッケージをビルドします：

   uv build
   

3. PyPIに公開します：

   uv publish
   

デバッグ

MCPサーバーは標準入力/出力を通じて動作するため、デバッグは難しい場合があります。MCP Inspectorの使用を強くおすすめします。

🔧 技術詳細

プロジェクト構造

xtquantai/
├── src/
│   └── xtquantai/
│       ├── __init__.py    # パッケージ初期化ファイル
│       └── server.py      # MCPサーバーの実装
├── main.py                # 起動スクリプト
├── server_direct.py       # 直接HTTPサーバーの実装
├── pyproject.toml         # プロジェクト設定
└── README.md              # プロジェクトドキュメント

📄 ライセンス

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

貢献

貢献を歓迎します！問題やプルリクエストをいつでも送信してください。

謝辞

• 迅投科技 が提供する定量取引プラットフォーム
• モデルコンテキストプロトコル が提供するAI統合フレームワーク