Twsemcpserver

🚀 TWStockMCPServer

このプロジェクトは、台湾証券取引所 (TWSE) のデータ分析に特化した、包括的なモデルコンテキストプロトコル (MCP) サーバーです。リアルタイムの株式情報、財務報告、ESG データ、およびトレンド分析機能を提供します。

🌏 言語バージョン

• English | 繁體中文

🚀 クイックスタート

🎬 デモビデオ

TWStockMCPServer の機能をご覧ください

✨ 主な機能

📊 テクニカル分析ツール

• 日次取引データ：リアルタイムの株価、取引量、取引統計
• 価格トレンド：日次終値と月平均価格の計算
• 評価指標：PER、配当利回り、PBR
• 過去のデータ：月次および年次の取引情報
• リアルタイム統計：5 秒ごとに更新される委託約定統計

💰 ファンダメンタル分析

• 財務報告：損益計算書と貸借対照表（一般企業）
• 収益報告：月次収益の追跡と成長分析
• 配当情報：配当記録と配当政策
• 企業統治：ESG データとガバナンス指標

🏛️ 市場情報

• 市場指数：リアルタイムの台湾株価指数情報と過去のデータ
• 機関投資家の動向：信用取引と貸借データ
• 市場統計：日次の市場概要と長期的なトレンド分析

🌱 ESG と持続可能性

• 気候管理：気候関連のリスク評価
• リスク管理：企業のリスク管理政策
• サプライチェーン：サプライチェーン管理の透明性
• 情報セキュリティ：ネットワークセキュリティイベントの報告

📦 インストール

システム要件

• Python 3.13 以上
• pip パッケージマネージャーまたは uv（推奨）

クイックスタート

1. プロジェクトをクローンする

   git clone https://github.com/yourusername/TWStockMCPServer.git
   cd TWStockMCPServer
   

2. 依存パッケージをインストールする

   pip を使用する場合：

   pip install -r requirements.txt
   

   uv を使用する場合（推奨）：

   uv sync
   

3. サーバーを起動する

   開発モード（ホットリロード）：

   uv run fastmcp dev server.py
   

   本番環境モード：

   uv run fastmcp run server.py
   

💻 使用例

利用可能なツール

企業情報

• get_company_profile(code) - 企業の基本情報
• get_company_dividend(code) - 配当分配データ
• get_company_monthly_revenue(code) - 月次収益報告

取引データ

• get_stock_daily_trading(code) - 日次取引統計
• get_stock_monthly_average(code) - 月平均価格
• get_stock_valuation_ratios(code) - 評価指標（PER、利回り、PBR）
• get_stock_monthly_trading(code) - 月次取引データ
• get_stock_yearly_trading(code) - 年次取引統計

財務報告

• get_company_income_statement(code) - 損益計算書（一般企業）
• get_company_balance_sheet(code) - 貸借対照表（一般企業）

市場データ

• get_market_index_info() - 市場指数情報
• get_margin_trading_info() - 信用取引統計
• get_real_time_trading_stats() - リアルタイム取引統計（5 秒ごとに更新）
• get_market_historical_index() - 発行量加重株価指数の過去データ

ESG とガバナンス

• get_company_governance_info(code) - 企業統治
• get_company_climate_management(code) - 気候関連管理
• get_company_risk_management(code) - リスク管理政策
• get_company_supply_chain_management(code) - サプライチェーンデータ
• get_company_info_security(code) - 情報セキュリティ指標

🤝 貢献の方法

開発者コミュニティの皆様からの貢献を歓迎します！以下の方法で協力いただけます。

貢献方法

1. 新しいツールの追加：API のカバレッジを拡張し、新しい TWSE エンドポイントを実装する
2. ドキュメントの改善：サンプルと説明ドキュメントの改善に協力する
3. バグ修正：問題の報告と修正を行う
4. 機能提案：新しい機能のアイデアを提案する
5. テスト：新しいテストケースを追加し、信頼性を向上させる

開発環境の設定

1. プロジェクトをフォークする
2. 機能ブランチを作成する

   git checkout -b feature/your-new-tool
   

3. server.py に新しいツールを追加する

   @mcp.tool
   def your_new_tool(code: str) -> str:
       """あなたのツールの説明。"""
       # 実装内容
   

4. 説明ドキュメントを更新する
5. Pull Request を提出する

API リファレンス

staticFiles/apis_summary_simple.json を参照して、新しいツールとして実装できる利用可能な TWSE API エンドポイントを確認してください。

コードスタイル

• Python PEP 8 ガイドラインに従う
• 完全な docstrings を追加する
• エラー処理を含める
• 重要な操作を記録する

📚 ドキュメント

API カバレッジ

現在、19 個の MCP Tools を提供しており、19 以上の TWSE API エンドポイントをカバーしています。

• 企業プロフィールと基本情報（3 つのツール）
• 株式取引データ（日次、月次、年次）（5 つのツール）
• 財務報告（2 つのツール）
• 市場指数とリアルタイム統計（4 つのツール）
• ESG とガバナンス指標（5 つのツール）
• 配当とガバナンス情報（企業情報に含まれる）

分析機能のカバレッジ

• テクニカル分析：日足、月足、年足の取引データ、リアルタイム統計
• ファンダメンタル分析：財務報告、収益データ、評価指標
• 資金分析：信用取引、機関投資家の動向
• 市場分析：大盤指数、過去のトレンド、市場統計

🔧 技術詳細

データソース

すべてのデータは台湾証券取引所 (TWSE) の公式オープン API から取得されます。

• 基本 URL：https://openapi.twse.com.tw/v1
• リアルタイムおよび過去のデータ
• API キーは不要
• レート制限が適用されます

📄 ライセンス

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

⚠️ 免責事項

このソフトウェアは参考目的のみで提供されており、投資助言を構成するものではありません。ユーザーは独自の調査を行い、投資決定を行う前に財務専門家に相談する必要があります。私は Python に不慣れであるため、このプロジェクトは完全に AI によって生成され、必要に応じて手動で調整されています。

🙏 謝辞

• 台湾証券取引所がオープンデータ API を提供してくれたこと
• MCP コミュニティがプロトコル規格を提供してくれたこと
• このプロジェクトに貢献し、利用してくれた皆様

📞 サポート

• 問題報告：GitHub Issues
• ディスカッション：GitHub Discussions
• ドキュメント：Wiki

愛を込めて台湾の株式分析コミュニティのために作られました