Fugle MCP Server

🚀 富果 MCP サービス

富果 MCP (モデルコンテキストプロトコル) サービスは、富果取引システムとの相互作用に使用されます。このサービスは株式相場の照会と取引機能をサポートしています。

🚀 クイックスタート

富果 MCP サービスを使うことで、株式相場の照会や取引機能を利用できます。以下に、インストール方法と使用方法を説明します。

✨ 主な機能

• リアルタイムの株式相場照会をサポート
• 過去のデータ照会をサポート
• 取引機能をサポート（オプション）
• Docker と NPM の 2 種類のデプロイ方法をサポート
• MCP プロトコルと完全互換

📦 インストール

NPM を使用する場合

npx fugle-mcp-server

Docker を使用する場合

docker pull kevinypfan/fugle-mcp-server

💻 使用例

環境変数

サービスには以下の環境変数が必要です。

• NATIONAL_ID: 身分証番号
• NOTIONAL_ID: 身分証番号（非推奨、NATIONAL_ID を使用してください）
• ACCOUNT_PASS: アカウントパスワード
• CERT_PASS: 証明書パスワード
• CERT_PATH: 証明書のパス（NPM 方式のみ必要）
• ENABLE_ORDER: 注文機能を有効にするかどうか（オプション、デフォルトは false）

⚠️ 重要通知

• バージョン 0.0.7 から、NOTIONAL_ID を NATIONAL_ID に改名しました。下位互換性のため、現在は 2 つの環境変数を使用できますが、NATIONAL_ID の使用を推奨します。
• 非推奨計画: NOTIONAL_ID はバージョン 0.1.0 で完全に削除されます。それまでに NATIONAL_ID に移行してください。

Docker の設定

.mcp-config.json に以下を追加します。

{
  "mcpServers": {
    "fugle-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--platform=linux/amd64",
        "-i",
        "--rm",
        "-e",
        "NATIONAL_ID",
        "-e",
        "ACCOUNT_PASS",
        "-e",
        "CERT_PASS",
        "-e",
        "ENABLE_ORDER",
        "--mount", "type=bind,src=</path/to/cert.p12>,dst=/app/cert.p12",
        "kevinypfan/fugle-mcp-server"
      ],
      "env": {
        "NATIONAL_ID": "<身分証番号>",
        "ACCOUNT_PASS": "<アカウントパスワード>",
        "CERT_PASS": "<証明書パスワード>",
        "ENABLE_ORDER": "<注文機能を有効にする ex: true または false>"
      }
    }
  }
}

NPM の設定

.mcp-config.json に以下を追加します。

{
  "mcpServers": {
    "fugle-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fugle-mcp-server"
      ],
      "env": {
        "NATIONAL_ID": "<身分証番号>",
        "ACCOUNT_PASS": "<アカウントパスワード>",
        "CERT_PASS": "<証明書パスワード>",
        "CERT_PATH": "<証明書のパス>",
        "ENABLE_ORDER": "<注文機能を有効にする ex: true または false>"
      }
    }
  }
}

コマンドラインオプション

• -v, --version: バージョン情報を表示