MCP Server

您可以在任何支持 MCP 的平台上使用我们基于 SDK 为 Tiger OpenAPI 构建的 MCP 工具。如您尚未开通 Tiger OpenAPI，请阅读准备工作，完成权限申请并获取 Tiger ID、私钥等必要信息。

行情权限说明：实时行情查询（实时行情、逐笔、深度行情等）需要单独购买 API 行情权限，与 App 内行情权限相互独立；K 线等历史行情的可用范围由历史行情额度等级决定。详情请参阅行情权限说明。

安装 [uv]

如果您使用 macOS/Linux 系统，打开「终端」并运行以下命令完成安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

如果您使用 Windows 系统，以管理员身份打开「 PowerShell 」并运行以下命令完成安装：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

备注：uv 是一个 Python 包和环境管理工具，此处用来运行 MCP Server。

添加 MCP Server

在您使用的工具中找到 MCP 入口，选择手动配置，并粘贴以下内容。

请将 your tiger id、your private key 和 your account id 替换为实际值。如需以只读模式运行（禁止交易操作），请将 TIGERMCP_READONLY 设为 true，否则设为 false。也可使用 TIGEROPEN_PROPS_PATH 指定配置文件路径，代替分别配置凭证。

{
  "mcpServers": {
    "tigermcp": {
      "command": "uvx",
      "args": [
        "--python",
        "3.13",
        "tigermcp"
      ],
      "env": {
        "TIGEROPEN_TIGER_ID": "your tiger id",
        "TIGEROPEN_PRIVATE_KEY": "your private key",
        "TIGEROPEN_ACCOUNT": "your account id",
        "TIGERMCP_READONLY": "true"
      }
    }
  }
}

请将 your tiger id、your private key、your secret key 和 your account id 替换为实际值。香港客户请同时将 TBHK 2fa token 替换为实际值，其他客户请删除该行。 如需以只读模式运行（禁止交易操作），请将 TIGERMCP_READONLY 设为 true，否则设为 false。

{
  "mcpServers": {
    "tigermcp": {
      "command": "uvx",
      "args": [
        "--python",
        "3.13",
        "tigermcp"
      ],
      "env": {
        "TIGEROPEN_TIGER_ID": "your tiger id",
        "TIGEROPEN_PRIVATE_KEY": "your private key",
        "TIGEROPEN_SECRET_KEY": "your secret key",
        "TIGEROPEN_ACCOUNT": "your account id",
        "TIGEROPEN_TOKEN": "TBHK 2fa token",
        "TIGERMCP_READONLY": "true"
      }
    }
  }
}

macOS 12 或以下版本运行 mcp server 错误及解决方案

如系统为 macOS 12 或以下版本，可能在运行 mcp server 时遇到以下错误：

/Users/tiger/.cache/uv/archive-v0/5iV7KVbKUQlypQW-eBHBn/bin/tigermcp: line 2: realpath: command not found
/Users/tiger/.cache/uv/archive-v0/5iV7KVbKUQlypQW-eBHBn/bin/tigermcp: line 2: /Users/tiger/python: No such file or directory
/Users/tiger/.cache/uv/archive-v0/5iV7KVbKUQlypQW-eBHBn/bin/tigermcp: line 2: exec: /Users/tiger/python: cannot execute: No such file or directory

这是因为缺少realpath命令，需要安装。
首先，打开终端，输入brew -v查看 brew 命令是否存在，如果报错命令不存在，则需要先安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后，用 brew 安装 coreutils

brew install coreutils

安装完成后，即可再次尝试运行 mcp server。

免责声明

TIGER MCP 仅为用户提供一种衔接 AI 与 TIGER API 的工具，实际的输出结果依赖于 AI 工具特性及所连接的大型语言模型能力，其中推理、分类和数据处理能力的差异以及平台限制条件等因素均可能影响结果的准确性与完整性，具体风险包括但不限于：时间理解偏差、数据分析错误、信息截断缺失和工具调用失效等。
所有通过使用 TIGER MCP 所做出的投资决策或其他操作，TIGER API 用户应具备相关知识、独立进行评估判断，并完善相关的安全与权限管理，TIGER API 用户将自行承担所有相关风险和责任。我们不对相关 AI 工具及模型输出结果的准确性、完整性、可靠性和及时性做出任何保证，也不对任何因此而引发的法律责任、经济损失或税务问题等承担任何责任。