mcpField
T
T-Invest

T-Invest

Local
github.com/prikotovFinance3Updated 68w ago
Repository

About T-Invest

T-Invest is a Symfony-based MCP server that provides account, portfolio, and company fundamentals tools through the T-Invest API. It is for users who want investment data in an MCP client, and can run locally or in a container.

Key features

  1. 01List user accounts
  2. 02Retrieve portfolios
  3. 03Filter portfolios by ticker
  4. 04Fetch company fundamentals
  5. 05Run locally or in containers

Use cases

  1. 01Inspect T-Invest account listings
  2. 02Check a portfolio by ticker
  3. 03Look up company fundamentals

MCP support

The MCP server exposes account, portfolio, and company fundamentals tools to clients through the T-Invest API.

#t-invest#stocks

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "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"
      ],
      "env": {
        "APP_T_INVEST_BASE_URL": "<APP_T_INVEST_BASE_URL>",
        "APP_T_INVEST_TOKEN": "<APP_T_INVEST_TOKEN>",
        "APP_T_INVEST_ACCOUNT_ID": "<APP_T_INVEST_ACCOUNT_ID>"
      }
    }
  }
}
Run commanddocker 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
Environment variables to set
APP_T_INVEST_BASE_URL
APP_T_INVEST_TOKENSecret
APP_T_INVEST_ACCOUNT_ID

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ociprikotov/t-invest-mcp-server:latest

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Сервер MCP для T-Invest API

Проект содержит консольное приложение на базе 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:

<YOUR_TOKEN> - токен T-Invest REST API. С инструкцией получения токена можно ознакомиться тут.

<YOUR_ACCOUNT_ID> - номер счета в T-Invest к которому подключается MCP Server.

Возможности (Tools)

  • 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 - исходный код Tools;
  • bin/ - консольные скрипты;
  • config/ - конфигурация Symfony;
  • tests/ - интеграционные тесты.
  • var/log - логи приложения.

Лицензия

Проект распространяется на условиях лицензии MIT. Полный текст лицензии см. в файле LICENSE.

Поддержка

Для вопросов и предложений:

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.