Tinkoff投资API服务器

一个轻量级的Go语言MCP服务器,用于与Tinkoff Investments进行交互,包括搜索金融工具、提交订单和管理投资组合。

  • by hightemp
  • Go
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 hightemp/go_mcp_server_tinvest

使用说明

Tinkoff Invest API的Go MCP服务器

一个轻量级的Go MCP服务器,用于与Tinkoff投资(工具搜索、应用程序、投资组合)一起工作。

make命令

  • Make Deps(Go Mod Tidy)
  • Make Build–构建二进制。/bin
  • Make Run在stdio中运行MCP服务器
  • 1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.1.http://HOST:PORT/sse)
  • Make Env显示重要的环境变量
  • Make Clean删除/bin

.env

TINKOFF_TOKEN=ваш_api_token
# Боевой эндпоинт:
TINKOFF_ENDPOINT=invest-public-api.tinkoff.ru:443
# Sandbox эндпоинт (если токен песочницы):
# TINKOFF_ENDPOINT=sandbox-invest-public-api.tinkoff.ru:443
# Рекомендуется в проде: ID открытого брокерского счёта
TINKOFF_ACCOUNT_ID=ваш_account_id
APP_NAME=go-mcp-tinvest

关键:令牌和端点必须与环境匹配(否则未经验证的40003)。选择正确的公文包 TINKOFF_ACCOUNT_ID (Notfound 50004)

发射

  • stdio(控制台): make run
  • SSE(httpсервер,服务器端事件): make run-sse HOST=localhost PORT=8100 连接到http://HOST:PORT/sse

MCP工具

下面列出了可用的MCP工具、参数和调用参数(JSON)示例。

  • 搜索股票

    • params:query(string)-票证或名称的一部分
    • 例如:{“query”:“sber”}
  • 搜索债券

    • params:查询(字符串)
    • 例如:{“query”:“ofz”}
  • Searchu funds-搜索基金/etf

    • params:查询(字符串)
    • 例如:{“query”:“fxus”}
  • 购买(市场申请)

    • 参数:
      • Ticker(字符串)-要搜索的Ticker或标题的一部分
      • lots(number):数量
    • 例如:{“ticker”:“sber”,“lots”:1}
    • 注意:将市场请求发送到服务器选择的帐户(请参阅环境变量)
  • 销售(市场申请)

    • 参数:
      • 自动收报机(字符串)
      • 批次(数量)
    • 例如:{“ticker”:“sber”,“lots”:1}
  • Portfolio–投资组合现状

    • Params:否
    • 例:{
  • 最后价格-工具的最后价格

    • params:query(string)-票证/标题/figi
    • 例如:{“query”:“sber”}
    • 结果:最新价格和报价时间
  • Orderbook-一个工具的请求杯

    • 参数:
      • 查询(字符串)-票证/名称/Figi
      • Depth(Number):杯子的深度(1–50)
    • 例如:{“查询”:“gazp”,“depth”:10}
    • 结果:最高出价/出价水平,价格和数量
  • 蜡烛-历史时期的蜡烛

    • 参数:
      • 查询(字符串)-票证/名称/Figi
      • From(string,rfc3339)-周期开始,例如 "2024-10-01T00:00:00Z"
      • TO(string,rfc3339)-期末,例如 "2024-10-02T00:00:00Z"
      • 间距(字符串)-其中一个:“1m”,“5m”,“15m”,“1h”,“1d”
    • пример:{“查询”:“YNDX”,“从”:“2024-10-01T00:00:00Z”,“到”:“2024-10-02T00:00:00Z“,“间隔”:“1h”}
    • 注意:引脚仅限于前50根蜡烛,以确保紧凑性
  • 交易状态-工具交易状态

    • params:query(string)-票证/标题/figi
    • 例如:{“query”:“tcsg”}
    • 结果:工具交易状态