Smart Finacial Mcp

Smart Financial MCP

Model Context Protocol（MCP）に基づくスマートな株式データアシスタントです。AI アシスタントと自然に会話しながら、株式データを取得できます。

🎯 プロジェクト概要

Smart Financial MCP は、Model Context Protocol に基づく金融データ MCP サーバーです。Tushare Pro API に接続し、投資調査、財務分析、業界分析に携わる方や AI アシスタントのユーザーに、株式データを手軽に検索する機能を提供します。

主な機能

• 🤖 AI アシスタント連携：Claude などの AI アシスタントとシームレスに会話できます
• 📊 リアルタイムデータ：Tushare Pro API に接続してリアルタイムの金融データを取得します
• 🔒 安全な管理：Tushare API Token をローカルで暗号化して保存します
• 📈 多様なデータ：株式、ETF、指数、先物など、さまざまな金融商品に対応します
• 🎨 スマート分析：財務分析レポートと可視化テーブルを自動生成します

技術アーキテクチャ

graph TD
    subgraph "用户交互层"
        AI[AI助手<br/>如Claude]
    end
    subgraph "MCP服务层"
        MCP[MCP服务器]
        Prompt[提示模板]
    end
    subgraph "数据服务层"
        Server[server.py]
        Tushare[Tushare Pro API]
    end
    subgraph "安全与配置"
        Env[环境变量]
        Token[Token管理]
    end
    
    AI --> |自然语言查询| MCP
    MCP --> |调用工具函数| Server
    Server --> |API请求| Tushare
    Tushare --> |返回数据| Server
    Server --> |格式化结果| MCP
    MCP --> |自然语言响应| AI
    Env --> |安全存储| Token
    Token --> |验证| Server

🚀 クイックスタート

動作要件

• Python 3.10 以降
• Tushare Pro アカウントと API Token

Tushare Token の設定

初回使用時に、Tushare Pro API Token を設定する必要があります。

1. Tushare Pro アカウントを登録します
2. API Token を取得します
3. AI アシスタントの setup_tushare_token ツールを使って設定します

🔧 MCP サーバーへの追加

{
  "mcpServers": {
    "smart-financial-mcp": {
      "command": "uvx",
      "args": ["smart-financial-mcp"],
      "env": {
        "TUSHARE_TOKEN": "your-tushare-token"
      }
    }
  }
}

📚 MCP ツール完全ガイド

ツール名	機能の説明	主なパラメーター	戻り値
Token 管理
check_token_status	Tushare token の設定状態を確認	なし	Token の状態情報と設定手順
株式の基本情報
get_stock_basic_info	株式の基本情報を取得	ts_code（株式コード） name（株式名）	株式コード、名称、所在地、業種、上場日、市場区分など
search_stocks	株式をスマート検索	keyword（必須、検索キーワード）	一致する株式の一覧。コードと名称のあいまい検索に対応
相場データ
get_daily_stock_price	A 株の日足相場データを取得	ts_code（株式コード、複数銘柄に対応） trade_date（取引日） start_date、end_date（期間）	始値、高値、安値、終値、騰落額、騰落率、出来高、売買代金、統計分析
get_realtime_stock_price	リアルタイム相場データを取得	ts_code（必須、6*.SH などのワイルドカードに対応）	リアルタイム価格、騰落率、売買情報、市場統計
get_etf_daily_price	ETF の日足相場を取得	ts_code（ファンドコード） trade_date（取引日） start_date、end_date（期間）	ETF の価格推移、売買データ、市場統計
get_index_daily_price	指数の日足相場を取得	ts_code（必須、399300.SZ などの指数コード） trade_date（取引日） start_date、end_date（期間）	指数値、騰落率、出来高、売買代金
get_futures_daily_price	先物の日足相場を取得	trade_date（取引日） ts_code（契約コード） exchange（取引所コード） start_date、end_date（期間）	先物価格、決済価格、建玉、売買データ
ファンダメンタル分析
get_daily_basic_indicators	日次の基本ファンダメンタル指標を取得	ts_code（株式コード） trade_date（取引日） start_date、end_date（期間）	PE、PB、PS、配当利回り、売買回転率、出来高比率、発行済み株式数、流通株式数、時価総額データ
get_income_statement	損益計算書データを取得し、スマート分析を生成	ts_code（必須、株式コード） start_date、end_date（期間） report_type（レポート種別。デフォルトは連結財務諸表）	財務データ表、収益分析、収益性分析、コスト・費用分析、1 株当たり指標の分析
市場データ
get_stock_limit_prices	値上がり・値下がり制限価格データを取得	ts_code（株式コード） trade_date（取引日） start_date、end_date（期間）	値上がり制限価格、値下がり制限価格、市場全体の制限価格統計、価格帯分析
get_financial_news	金融ニュース速報を取得	src（必須、ニュースソース） start_date、end_date（必須、期間）	ニュース一覧、時間分布の統計、注目キーワードの抽出
プロンプトテンプレート
income_statement_query	損益計算書の検索ガイドテンプレート	なし	損益計算書を検索するための詳細なガイドと例

📊 対応するデータの種類

指数コードの例：

• 399300.SZ：CSI 300
• 000001.SH：上海総合指数
• 399001.SZ：深セン成分指数
• 399006.SZ：ChiNext 指数
• 000905.SH：CSI 500

先物取引所：

• SHF：上海先物取引所
• DCE：大連商品取引所
• CZE：鄭州商品取引所
• INE：上海国際エネルギー取引センター

ニュースソース：

• sina：新浪財経
• wallstreetcn：華爾街見聞
• 10jqka：同花順
• eastmoney：東方財富
• cls：財聯社
• yicai：第一財経

💡 使用例

基本的な検索

"查询平安银行的基本信息"
"搜索包含新能源的股票"
"获取贵州茅台最近一个月的股价"

詳細分析

"分析平安银行2023年的利润表"
"查询沪深300指数最近一周的走势"
"获取今日涨停股票统计"

市場モニタリング

"获取今日财联社快讯"
"查询创业板ETF的实时行情"
"分析中证500的每日基本面指标"

🔒 データセキュリティ

• ローカル保存：Token はローカルの ~/.tushare_mcp/.env ファイルに保存されます
• 暗号化通信：すべての API 呼び出しで HTTPS 暗号化を使用します
• アクセス制御：Tushare Pro のポイント制度に基づいてアクセスを制御します

🤝 貢献ガイド

1. このリポジトリを Fork します
2. 機能ブランチを作成します：git checkout -b feature/AmazingFeature
3. 変更をコミットします：git commit -m 'Add some AmazingFeature'
4. ブランチにプッシュします：git push origin feature/AmazingFeature
5. Pull Request を作成します

開発環境

# 克隆仓库
git clone https://github.com/YUHAI0/smart-financial-mcp.git
cd smart-financial-mcp

# 安装开发依赖
pip install -e ".[dev]"

# 运行代码质量检查
black smart_financial_mcp/
isort smart_financial_mcp/
flake8 smart_financial_mcp/
mypy smart_financial_mcp/

📄 オープンソースライセンス

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

🙏 謝辞

• Tushare Pro - 専門的な金融データ API を提供
• Model Context Protocol - AI アシスタント連携フレームワークを提供
• FastMCP - 効率的な MCP サーバー実装を提供

📞 お問い合わせ

• 作者：yuhai
• メール：[email protected]
• プロジェクト URL：https://github.com/YUHAI0/smart-financial-mcp
• 問題の報告：https://github.com/YUHAI0/smart-financial-mcp/issues

---

⭐ このプロジェクトがお役に立った場合は、スターを付けてください！

🚀 Smart Financial MCP を使い始めて、AI アシスタントを専門的な金融データアナリストにしましょう！