MCP Server Upstox Api

🚀 Upstox API MCP サーバー

Upstox 取引 API と統合するための MCP サーバーです。このサーバーを使用することで、自然言語で Upstox API とやり取りできます。

🚀 クイックスタート

セットアップ

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 や Cursor と連携して使用できます。また、自然言語で Upstox API の様々なエンドポイントにアクセスできます。

📦 インストール

上記のクイックスタートの手順に従って、サーバーをセットアップしてください。

💻 使用例

基本的な使用法

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 プロフィール情報は何ですか？"
• "私の現在のアクティブなセグメントと製品を表示してください"
• "私のユーザー ID とメールアドレスは何ですか？"

資金と証拠金

• "私の利用可能な証拠金はいくらですか？"
• "私の株式セグメントの資金と証拠金の詳細を表示してください"
• "私の商品セグメントの証拠金の利用可能性はいくらですか？"

保有株

• "私は現在どの株を保有していますか？"
• "私の長期保有株とその現在の価値を表示してください"
• "私が保有する総保有価値はいくらですか？"

注文

• "私には現在どの未決済注文がありますか？"
• "私の日内注文とその損益（P&L）を表示してください"
• "私の未決済注文の総未実現損益はいくらですか？"

MTF 注文

• "私の Margin Trade Funding 注文は何ですか？"
• "私の MTF 注文とその現在の価値を表示してください"
• "私のアカウントの総 MTF エクスポージャーはいくらですか？"

注文帳

• "今日の Upstox での注文を表示してください"
• "私の保留中の注文は何ですか？"
• "今日の注文履歴を表示してください"
• "私の注文の状態は何ですか？"
• "今日完了した注文をリストアップしてください"

注文詳細

• "注文 ID xxxxxxxxxxxxxxx の詳細情報を表示してください"
• "注文 ID xxxxxxxxxxxxxxx の状態は何ですか？"
• "注文 xxxxxxxxxxxxxxx の完全な情報を取得してください"
• "注文 xxxxxxxxxxxxxxx の実行状態を確認してください"
• "最近の注文 xxxxxxxxxxxxxxx の詳細を確認してください"

注文履歴

• "注文 ID xxxxxxxxxxxxxxx の履歴を表示してください"
• "注文 xxxxxxxxxxxxxxx のすべての状態更新を取得してください"
• "注文 xxxxxxxxxxxxxxx の進捗は何ですか？"
• "注文 xxxxxxxxxxxxxxx のすべての段階を表示してください"
• "ラベル xxxxxxxxxxxxxxx 付きの注文履歴を取得してください"

取引注文

• "注文 ID xxxxxxxxxxxxxxx に対応する取引を表示してください"
• "注文 ID xxxxxxxxxxxxxxx で実行された取引は何ですか？"
• "注文 xxxxxxxxxxxxxxx の取引詳細を取得してください"
• "注文 xxxxxxxxxxxxxxx に関連付けられたすべての取引をリストアップしてください"
• "注文 xxxxxxxxxxxxxxx の実行詳細を表示してください"

取引

• "今日の取引を表示してください"
• "今日実行された取引は何ですか？"
• "私の毎日の取引履歴を取得してください"
• "私が完了した当日取引をリストアップしてください"
• "私の取引詳細とその約定価格を表示してください"

📚 ドキュメント

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

リクエスト例

買い注文の送信

{
  "type": "submit_order",
  "order": {
    "exchange": "SSE",
    "symbol": "600028",
    "side": "buy",
    "order_type": "limit",
    "price": 10.5,
    "quantity": 100
  }
}

注文状態の照会

{
  "type": "get_order_status",
  "order_id": "123456"
}

レスポンス形式

すべての API リクエストは統一された JSON 形式で返されます：

{
  "success": boolean, // 成功したかどうか
  "data": any,       // データ部分
  "error": {
    "code": string,
    "message": string
  } // エラー情報（失敗時のみ返されます）
}

エラー処理

一般的なエラーコードとメッセージ：

• invalid_params：無効なパラメーター
• order_not_found：注文が見つかりません
• insufficient_balance：残高不足
• symbol_not_found：銘柄が見つかりません
• invalid_order_type：無効な注文タイプ
• network_error：ネットワークエラー

API リクエストを処理する際には、返されるステータスコードとエラー情報を確認し、適切に例外を処理してください。