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 配置

要在 Claude Desktop 中使用此 MCP 服务，请将以下配置添加到 Claude Desktop 设置中：

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

Cursor MCP 配置

要在 Cursor 中使用此 MCP 服务，请将以下配置添加到 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 仓位

• “我有哪些保证金交易融资仓位？”
• “显示我的 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	获取用户资金和保证金信息。可选的 segment 参数可以是 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	获取用户当日的成交记录