Fubon MCP Server

🚀 富邦証券市場資料 MCP サーバー

富邦証券市場資料 MCP (Model Communication Protocol) サーバーは、台湾株式の歴史データを取得するために使用されます。

🚀 クイックスタート

富邦証券市場資料 MCP サーバーを使用することで、台湾株式の歴史データを簡単に取得できます。以下の手順に従ってサーバーをセットアップし、データを取得しましょう。

✨ 主な機能

• 台湾株式および ETF の歴史 K 線データの照会をサポート
• ローカルデータキャッシュにより、API 呼び出し回数を削減
• 長期間のデータ要求を自動的に分割処理
• データの重複排除とソートをサポート
• 追加の計算フィールド（取引額、騰落、騰落率）を提供

📦 インストール

システム要件

• Python 3.8 以上のバージョン
• 富邦証券の電子証明書
• macOS / Linux / Windows

インストール手順

1. プロジェクトをクローンします：

git clone https://github.com/yourusername/fubon-mcp-server.git
cd fubon-mcp-server

2. 仮想環境を作成します：

python3 -m venv .venv
source .venv/bin/activate  # macOS/Linux
# または
.venv\Scripts\activate  # Windows

3. 依存パッケージをインストールします：

pip install -r requirements.txt

4. 環境変数を設定します： 以下の環境変数を .env ファイルに追加します：

FUBON_USERNAME=あなたの富邦証券アカウント
FUBON_PASSWORD=あなたの富邦証券パスワード
FUBON_PFX_PATH=/path/to/your/certificate.pfx
FUBON_DATA_DIR=/path/to/your/data/directory

💻 使用例

基本的な使用法

サーバーの起動

python server.py

VS Code での MCP の設定

VS Code の設定ファイルに以下を追加します：

{
  "mcpServers": {
    "fubon-mcp-server": {
      "command": "/path/to/your/.venv/bin/python3",
      "args": ["/path/to/your/server.py"],
      "env": {
        "FUBON_USERNAME": "あなたの富邦証券アカウント",
        "FUBON_PASSWORD": "あなたの富邦証券パスワード",
        "FUBON_PFX_PATH": "/path/to/your/certificate.pfx",
        "FUBON_DATA_DIR": "/path/to/your/data/directory"
      }
    }
  }
}

📚 ドキュメント

API 説明

歴史 K 線データの取得

historical_candles({
    "symbol": "2330",      # 株式コード
    "from_date": "2024-03-01",  # 開始日
    "to_date": "2024-03-24"     # 終了日
})

ローカル歴史データの照会

GET twstock://{symbol}/historical

⚠️ 注意事項

⚠️ 重要提示

あなたの富邦証券アカウントのパスワードと電子証明書を適切に保管してください。 API 呼び出しには、日々の回数制限がある可能性があります。長期間のデータは自動的に分割して要求されます。

💡 使用建议

適切なデータキャッシュディレクトリを設定することをおすすめします。

📄 ライセンス

MIT License

貢献ガイド

Issue と Pull Request の提出を歓迎します。

作者

Hans Li
https://medium.com/@mingyawli

更新ログ

v0.1.0

• 初期バージョンのリリース
• 基本的な歴史データ照会をサポート
• ローカルデータキャッシュを実装