Upstox MCP Server

Upstox MCP Server

Upstox API を操作するための MCP サーバー

Upstox MCP Server は、Upstox API を使用した取引や資金分析を行うために設計された、軽量なプラグインベースの Model Context Protocol (MCP) サーバーです。

リポジトリの詳細は、deepwiki をご覧ください

目次

• クライアントの前提条件
• サーバーの利用を開始する
• 利用可能なツール

クライアントの前提条件

Claude AI（Anthropic）からサーバーを利用する場合：

• claude.ai からインストールした Claude Desktop App
• Node.js

サーバーの利用を開始する

1. Upstox アカウントをお持ちの場合、次の URL にアクセスして、サンドボックスアプリを作成します。**https://account.upstox.com/developer/apps#sandbox**。サンドボックスアプリに名前を付けます。リダイレクト URL には http://localhost:8000 を設定できます。
2. API Key と API SECRET を、サーバー名とともに以下の内容で .env ファイルに保存します。

   SERVER_NAME=SERVER_NAME
   UPSTOX_API_KEY=upstox_api_key
   UPSTOX_SECRET_KEY=upstox_secret_key
   

3. Upstox の銘柄キーをこちらからダウンロードし、data/ フォルダーに保存します。https://upstox.com/developer/api-documentation/instruments/#json-files
4. setup.sh シェルファイルを実行して、サーバーをセットアップします。サーバーの依存関係を確認し、access_token スクリプトを実行して Upstox から access_token を取得します。ブラウザーウィンドウが開くので、access token の取得に進む前に Upstox の PIN を入力してください。また、株式の市場価格を取得するために適切な銘柄キーを取得するコレクションも作成されます。
5. Claude（またはお使いのカスタム MCP クライアント）を開いて、サーバーを使い始めましょう！

利用可能なツール

ツール名	説明
get_profile_details_tool	Upstox からユーザープロフィールの詳細を取得します
get_user_funds_margin_tool	Upstox から資金の詳細を取得します
get_holdings_tool	Upstox から保有資産を取得します
get_market_price_tool	株式の現在価格を取得します
place_order_tool	特定の株式について Upstox で注文します
get_brokerage_details_tool	指定した株式に適用される仲介手数料を取得します
list_capabilities_tool	サーバーで利用可能なすべてのツールを一覧表示します