mcp-server-upstox-api

mcp-server-upstox-api

Upstox 取引 API と連携するための MCP サーバーです。

クイックスタート

セットアップ

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

npm install

サーバーの起動

MCP サーバーを起動するには：

npm run start

MCP サーバーは http://localhost:8787 で実行されます。

MCP の設定

Claude Desktop の設定

この MCP サーバーを Claude Desktop で使用するには、以下の設定を Claude Desktop の設定に追加します：

{
  "mcpServers": {
    "mcp-server-upstox-api": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

Cursor MCP の設定

この MCP サーバーを Cursor で使用するには、以下の設定を Cursor の MCP 設定（通常は ~/.cursor/mcp.json）に追加します：

{
  "mcpServers": {
    "mcp-server-upstox-api": {
      "url": "http://localhost:8787/sse"
    }
  }
}

これらの設定により、Claude Desktop と Cursor がローカルの MCP サーバーに接続し、Upstox API のエンドポイントを使用できるようになります。

Claude と Cursor での使用方法

自然言語のプロンプトを使って Upstox API を操作できます。各コマンドのプロンプト例を以下に示します：

プロフィール情報

• 「Upstox のプロフィール情報を教えてください」
• 「Upstox の有効なセグメントと商品を表示してください」
• 「Upstox のユーザー ID とメールアドレスを教えてください」

資金と証拠金

• 「Upstox で利用可能な証拠金を教えてください」
• 「株式セグメントの資金と証拠金の詳細を表示してください」
• 「商品セグメントで利用可能な証拠金を教えてください」

保有資産

• 「現在 Upstox で保有している株式は何ですか？」
• 「長期保有資産と現在の評価額を表示してください」
• 「Upstox で保有している資産の合計額を教えてください」

ポジション

• 「Upstox で現在保有しているオープンポジションは何ですか？」
• 「損益付きで日中ポジションを表示してください」
• 「現在のポジションの未実現損益合計を教えてください」

MTF ポジション

• 「Margin Trade Funding のポジションを教えてください」
• 「現在の評価額付きで MTF ポジションを表示してください」
• 「口座の MTF エクスポージャー合計を教えてください」

注文一覧

• 「Upstox で今日出した注文を表示してください」
• 「Upstox の保留中の注文を教えてください」
• 「今日の注文履歴を表示してください」
• 「最近の注文のステータスを教えてください」
• 「今日完了した注文をすべて一覧表示してください」

注文の詳細

• 「注文 ID xxxxxxxxxxxxxxx の詳細を表示してください」
• 「ID xxxxxxxxxxxxxxx の注文のステータスを教えてください」
• 「注文 xxxxxxxxxxxxxxx の完全な情報を取得してください」
• 「注文 xxxxxxxxxxxxxxx の約定状況を確認してください」
• 「最近の注文 xxxxxxxxxxxxxxx の詳細を表示してください」

注文履歴

• 「注文 ID xxxxxxxxxxxxxxx の履歴を表示してください」
• 「注文 xxxxxxxxxxxxxxx のステータス更新をすべて取得してください」
• 「注文 xxxxxxxxxxxxxxx の推移を教えてください」
• 「注文 xxxxxxxxxxxxxxx のすべての段階を表示してください」
• 「タグ xxxxxxxxxxxxxxx の注文履歴を取得してください」

注文の取引

• 「注文 ID xxxxxxxxxxxxxxx の取引を表示してください」
• 「注文 xxxxxxxxxxxxxxx で約定した取引を教えてください」
• 「注文 xxxxxxxxxxxxxxx の取引詳細を取得してください」
• 「注文 xxxxxxxxxxxxxxx に関連付けられた取引をすべて一覧表示してください」
• 「注文 xxxxxxxxxxxxxxx の約定詳細を表示してください」

取引

• 「今日の取引を表示してください」
• 「今日はどのような取引を実行しましたか？」
• 「日次の取引履歴を取得してください」
• 「今日完了した取引をすべて一覧表示してください」
• 「約定価格付きで取引の詳細を表示してください」

利用可能なエンドポイント

エンドポイント	メソッド	説明
/get-profile	GET	ユーザープロフィール情報を取得します
/get-funds-margin	GET	ユーザーの資金と証拠金に関する情報を取得します。オプションのセグメントパラメーターには、「SEC」（株式）または「COM」（商品）を指定できます
/get-holdings	GET	ユーザーの長期保有資産に関する情報を取得します
/get-positions	GET	ユーザーの短期ポジションに関する情報を取得します
/get-mtf-positions	GET	ユーザーの信用取引ファンディング（MTF）ポジションに関する情報を取得します
/get-order-book	GET	ユーザーの当日注文とそのステータスを取得します
/get-order-details	GET	注文 ID を使用して、特定の注文の詳細情報を取得します
/get-order-trades	GET	注文 ID を使用して、特定の注文で約定した取引を取得します
/get-order-history	GET	注文 ID またはタグを使用して注文履歴を取得します
/get-trades	GET	ユーザーの当日に約定した取引を取得します