投资API服务器

Tinkoff Invest MCP服务器

用于Tinkoff Invest API的MCP服务器。

安装

源代码

uv tool install git+https://github.com/akaGelo/tinkoff-invest-mcp.git

开发

git clone git@github.com:akaGelo/tinkoff-invest-mcp.git
cd tinkoff-invest-mcp
uv tool install --editable .

Конфигурация

环境变化

所需变量：

• TINKOFF_令牌 -API投资
• TINKOFF_ACCOUNT_ID -交易限制账户ID（安全必填）
• TINKOFF_MODE -工作方式： sandbox （默认）或 production
• TINKOFF_APP_NAME -登录应用程序名称（可选）

Пример.envфайла

TINKOFF_TOKEN=your_api_token_here
TINKOFF_ACCOUNT_ID=your_account_id_here
TINKOFF_MODE=sandbox
TINKOFF_APP_NAME=tinkoff-invest-mcp

测试

您可以使用MCP Inspector进行调试：

npx @modelcontextprotocol/inspector

可用的MCP方法

服务器提供了18种通过MCP协议处理Tinkoff Invest API的方法。

💰 投资组合和资产负债表

get_cash_balance

获得账户现金余额。

• 按每种货币返回可用和冻结的资金

get_portfolio

得到公文包的组成。

• 返回所有项目与数量，价格，平均购买价格和P&L信息

📊 Операции и история

get_operations

获取期间内的账户交易。

• from_date -ISO 8601格式的起始日期
• to_date -结束日期（可选）
• state -按操作状态筛选器：
  • OPERATION_STATE_EXECUTED -已完成的交易
  • OPERATION_STATE_CANCELED -取消的交易
• instrument_uid -工具过滤器

📈 市场数据

get_candles

在一段时间内从工具中获取蜡烛。

• instrument_uid -工具ID
• from_date -起始日期
• to_date -结束日期（可选）
• interval -蜡烛间隔：
  • CANDLE_INTERVAL_1_MIN - 1 минута
  • CANDLE_INTERVAL_5_MIN - 5分钟
  • CANDLE_INTERVAL_15_MIN - 15分钟
  • CANDLE_INTERVAL_HOUR 1小时
  • CANDLE_INTERVAL_DAY 1天

get_last_prices

从工具列表中获取最新价格。

• instrument_uids -工具标识符数组

get_order_book

得到一杯工具的申请。

• instrument_uid -工具ID
• depth -杯子的深度（默认为10）

get_trading_schedules

获取交易时间表。

• exchange -交易所代码（默认为“MOEX”）
  • MOEX 莫斯科交易所
  • MOEX_PLUS -MOEX Plus
  • MOEX_EVENING_WEEKEND -MOEX晚间和周末交易
  • SPB - СПБ Биржа
• from_date -起始日期（可选）
• to_date -结束日期（可选）

get_trading_status

获得工具的交易状态。

• instrument_uid -工具ID

🛒 贸易申请

create_order

创建贸易申请。

• instrument_id -工具ID
• quantity -批量数量
• direction -方向：
  • ORDER_DIRECTION_BUY -购买
  • ORDER_DIRECTION_SELL -销售
• order_type -申请类型：
  • ORDER_TYPE_MARKET -市场申请
  • ORDER_TYPE_LIMIT -限额申请
• price -价格（仅限限量订单，浮动）

cancel_order

取消交易申请。

• order_id -申请标识符

get_orders

获取活动贸易申请表。

🛑 停止申请

post_stop_order

创建停止申请。

• instrument_id -工具ID
• quantity -批量数量
• direction -方向：
  • STOP_ORDER_DIRECTION_BUY -购买
  • STOP_ORDER_DIRECTION_SELL -销售
• stop_order_type -停止申请类型：
  • STOP_ORDER_TYPE_TAKE_PROFIT -利润丰厚
  • STOP_ORDER_TYPE_STOP_LOSS -停下来。
  • STOP_ORDER_TYPE_STOP_LIMIT -停止限制
• stop_price 激活价格（Float）
• expiration_type -过期类型：
  • STOP_ORDER_EXPIRATION_TYPE_GOOD_TILL_CANCEL 取消前
  • STOP_ORDER_EXPIRATION_TYPE_GOOD_TILL_DATE -直到日期
• price -执行价格（stop_loss为0，take_profit>0，stop_limit，float）
• expire_date -过期日期（可选为good_till_date）

cancel_stop_order

取消停止申请。

• stop_order_id -停止申请ID

get_active_stop_orders

获取活动停止申请列表。

🔍 工具搜索

find_instrument

Найти инструмент по запросу.

• query -搜索查询（票证、ISIN、FIGI或标题）

get_instrument_by_uid

通过UID获取工具。

• uid -唯一的工具ID

get_shares

得到股票清单。

• limit -最大数量（默认为10）
• offset -压痕偏移（默认为0）

get_bonds

得到债券清单。

• limit -最大数量（默认为10）
• offset -压痕偏移（默认为0）

get_etfs

获取ETF列表。

• limit -最大数量（默认为10）
• offset -压痕偏移（默认为0）