T-Invest

T-Invest API 的 MCP 服务

该项目包含一个基于 Symfony 的命令行应用，用于实现 MCP（Model Context Protocol）服务。 该服务提供了用于操作 T-Invest API 的工具。

该服务使用 logiscape/mcp-sdk-php 库

配置

{
  "mcpServers": {
    "t-invest": {
      "command": "docker",
      "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "APP_T_INVEST_BASE_URL",
          "-e",
          "APP_T_INVEST_TOKEN",
          "-e",
          "APP_T_INVEST_ACCOUNT_ID",
          "prikotov/t-invest-mcp-server:latest",
          "bin/server"
      ],
      "env": {
          "APP_T_INVEST_BASE_URL": "<API ENDPOINT>",
          "APP_T_INVEST_TOKEN": "<YOUR_TOKEN>",
          "APP_T_INVEST_ACCOUNT_ID": "<YOUR_ACCOUNT_ID>"
      }
    }
  }
}

其中， 是 T-Invest REST API Endpoint：

• https://invest-public-api.tinkoff.ru/rest/ - 生产服务
• https://sandbox-invest-public-api.tinkoff.ru/rest/ - 沙盒。

<YOUR_TOKEN> 是 T-Invest REST API 令牌。获取令牌的说明请参阅此处。

<YOUR_ACCOUNT_ID> 是要连接 MCP Server 的 T-Invest 账户编号。

功能（工具）

• get_accounts - 返回用户的账户列表；
• get_portfolio - 返回客户端的投资组合。支持按股票代码筛选；
• get_asset_fundamentals - 返回指定股票代码对应公司的基本面指标；

开发者信息

要求

• PHP 版本 8.3 或更高；
• Composer。

应用既可以在本地运行，也可以在 Docker 中运行。

安装

克隆代码库并安装依赖项：

composer install

运行

本地

bin/server

或者使用传统方式：

php bin/console app:mcp-server

或者使用 podman：

podman run --rm -i t-invest-mcp-server bin/console app:mcp-server

该服务会输出可用工具列表，并允许调用其中的每个工具。可通过以下命令进行检查：

podman-compose run --rm t-invest-mcp-server bin/console app:mcp-client --via=console

选项 --via 用于选择服务的启动方式（console、podman 或 docker）。默认使用 console。

Docker（Podman）

项目中包含 Dockerfile 和 compose.yaml。要构建并启动容器，请运行：

podman build -t t-invest-mcp-server .

Makefile

使用 Make 自动化常见任务。主要目标：

make help         # вывести справку
make build        # собрать Docker-образ
make push         # отправить образ в репозиторий
make cache-clear  # очистить кэш приложения
make test-all     # запустить тесты и пример клиента
make tests        # запустить юнит тесты
make psalm        # статический анализ
make phpcs        # проверка стиля кода

测试

在本地运行测试：

./bin/phpunit

或者通过 Make 使用单条命令：

make tests

或者通过 docker：

docker-compose run --rm t-invest-mcp-server bin/phpunit

或者通过 podman：

podman-compose run --rm t-invest-mcp-server bin/phpunit

测试会将客户端连接到服务并调用其工具。

项目结构

• src/ - 应用源代码；
• src/Tool - 工具源代码；
• bin/ - 命令行脚本；
• config/ - Symfony 配置；
• tests/ - 集成测试。
• var/log - 应用日志。

许可证

本项目基于 MIT 许可证发布。许可证全文请参阅 LICENSE 文件。

支持

如有问题或建议：

• Issues
• Email：[email protected]