T-Bank Invest (read-only)

T-Bank Invest MCP サーバー（読み取り専用）

AI アシスタントを通じて、T-Bank（Tinkoff）の投資ポートフォリオを操作するための MCP サーバーです。読み取り専用で、取引の実行、資金の引き出し、口座設定の変更はできません。

機能

• ポートフォリオと口座 — 口座、ポジション、収益率、証拠金指標の確認
• 取引履歴 — 取引、配当、クーポン、税金、手数料をフィルタリングやページネーションで確認
• 金融商品検索 — ティッカー、名称、ISIN、FIGIで検索。株式、債券、ETF、通貨、先物の詳細情報
• 市場データ — ローソク足（OHLCV）、板情報、取引状況、終値
• 分析 — テクニカル分析（SMA、EMA、RSI、MACD、Bollinger Bands）、ファンダメンタル指標（P/E、EPS、ROE）、アナリストのコンセンサス予測、および get_stock_snapshot — 1回の呼び出しでティッカーの概要を取得（ファンダメンタル情報＋株価変動＋コンセンサス）
• 債券 — クーポンカレンダー、未収クーポン利息、イベント（償還、期限前償還請求）
• 配当 — 過去の配当と今後の支払い

要件

• uv — 1つのコマンドでサーバーを起動します。Python 3.11+を自動で選択し、分離された環境に依存関係をインストールします
• T-Invest API トークン — tbank.ru/invest/settings/apiで発行します

発行するトークンの種類

読み取り専用（readonly）トークンを発行してください。サーバーが呼び出すのは読み取りメソッドのみで、取引権限は不要です。このトークンを使えば、サーバーのコードに加え、T-Bank側でも取引注文を実行できないため、二重の保護になります。トークンの利用を1つの口座に限定することもできます。

MCP クライアントはトークンを設定内に平文で保存するため、取引権限を付与しないことが重要です。

接続

サーバーはPyPIで公開されています。リポジトリをクローンする必要はなく、uvxがダウンロードして起動します。トークンは、MCP クライアントの設定で環境変数TBANK_INVEST_TOKENを通じて渡します。

Claude Code

claude mcp add t-bank-invest -e TBANK_INVEST_TOKEN=your_token_here -- uvx t-bank-invest-mcp-read-only

デフォルトではサーバーは現在のプロジェクトにのみ接続されます。すべてのプロジェクトで利用できるようにするには、--scope userを追加してください。--scope projectを指定すると、トークンを含む設定がプロジェクトのルートにある.mcp.jsonに書き込まれます。このファイルをコミットしないでください。

Claude Desktop

claude_desktop_config.json（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\）にサーバーを追加し、アプリケーションを再起動してください。

{
  "mcpServers": {
    "t-bank-invest": {
      "command": "uvx",
      "args": ["t-bank-invest-mcp-read-only"],
      "env": {
        "TBANK_INVEST_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Desktopがuvxを見つけられない場合は、commandにuvxの完全なパスを指定してください（which uvxで確認できます）。

その他の MCP クライアント

サーバーはstdioで動作します。任意のクライアントで、Claude Desktopの例と同じコマンド、引数、環境変数を指定してください。

サーバーはレジストリ MCP サーバーにも、io.github.Sicness/t-bank-invest-mcp-read-onlyという名前で登録されています。

特定のバージョン

uvxはPyPIから最新バージョンを取得し、自動で更新します。バージョンを固定するには、名前の後に [email protected]のように指定してください。各バージョンの変更内容は変更履歴をご覧ください。

まだリリースされていないmainブランチの状態を使う場合：uvx --from git+https://github.com/Sicness/t-bank-invest-mcp-read-only t-bank-invest-mcp-read-only。

ソースからのインストール

開発目的、またはuvが適さない場合：

git clone https://github.com/Sicness/t-bank-invest-mcp-read-only.git
cd t-bank-invest-mcp-read-only
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[test]"

その場合、MCP クライアントの設定にはコマンドの完全なパスを指定します：/path/to/t-bank-invest-mcp-read-only/.venv/bin/t-bank-invest-mcp-read-only。argsは不要です。

直接起動

サーバーは .env ファイルを読み込みません。変数は shell でエクスポートする必要があります。

export TBANK_INVEST_TOKEN=your_token_here
uvx t-bank-invest-mcp-read-only

インストール済みの環境からは、t-bank-invest-mcp-read-only コマンドまたは python -m tbank_invest_mcp でも同じように実行できます。

利用可能なツール

口座とユーザー

ツール	説明
get_accounts	投資口座の一覧
get_user_info	料金プラン、適格投資家のステータス、リスクレベル
get_margin_attributes	口座の証拠金指標

ポートフォリオとポジション

ツール	説明
get_portfolio	価格と収益率を含むポートフォリオ全体。ポジションではゼロのフィールドが省略されます
get_positions	価格計算を行わないポジション残高
get_withdraw_limits	出金可能な資金

取引

ツール	説明
get_operations	期間を指定した取引履歴
get_operations_by_cursor	ページネーションと高度なフィルターに対応した取引履歴

金融商品

ツール	説明
find_instrument	ティッカー、名称、ISIN、FIGIで検索します。デフォルトでは API 経由で取引可能な証券のみが対象で、最大20件です。金融商品の種類によるフィルターも利用できます
get_instrument_by	ID による詳細情報
get_bond_by	債券情報
get_share_by	株式情報
get_etf_by	ETF／ファンド情報
get_currency_by	通貨金融商品に関する情報
get_future_by	先物契約情報
get_bond_coupons	債券のクーポンカレンダー
get_bond_events	債券イベント：クーポン、公開買付け、償還、転換。種類と期間でフィルターできます
get_dividends	過去および今後の配当
get_accrued_interests	経過利息（累積クーポン収入）
get_asset_fundamentals	P/E、EPS、ROE、時価総額
get_consensus_forecasts	1つの金融商品に関するアナリストのコンセンサス予測（ページをスキャンし、instrument_id でフィルターします。instrument_id は金融商品または資産の UID です。API 自体はサーバー側でフィルターできないためです）
get_forecast_by	金融商品に関する投資会社の予測
get_asset_reports	発行体の決算報告日
get_stock_snapshot	1回の呼び出しで株式の概要を取得します。ティッカー → UID → 資産 UID を解決し、ファンダメンタルズ、N 取引セッションの価格変動、コンセンサス予測をまとめます
get_favorites	ユーザーのお気に入り金融商品
get_trading_schedules	取引所の取引スケジュール

市場データ

ツール	説明
get_candles	過去のローソク足（OHLCV）。[時刻、open、high、low、close、出来高、買い、売り] の文字列
get_last_prices	直近の約定価格
get_close_prices	前のセッションの終値
get_order_book	板情報（bids/asks）
get_trading_status	現在の取引状況
get_tech_analysis	テクニカル指標（SMA、EMA、RSI、MACD、BB）

注文

ツール	説明
get_orders	口座の有効な注文
get_order_state	特定の注文のステータス

金融商品の一覧

ツール	説明
list_shares	株式の完全な一覧：約2 MB
list_bonds	債券の完全な一覧：約2.4 MB
list_etfs	ETF／ファンドの完全な一覧：約300 KB
list_currencies	すべての通貨金融商品：約13 KB
list_futures	先物の完全な一覧：約700 KB

通貨を除く一覧はスクリプト向けのデータダンプです。モデルのコンテキストに収まらないため、クライアントはこのような応答をファイルに保存するか、拒否します。証券を検索するには、find_instrument を使用してください。

Формат данных

Ответы рассчитаны на то, что их читает модель, поэтому сервер не пересылает ответ API как есть:

• Цены и суммы — обычные числа, а не пары units/nano. Валюта указана один раз, в поле currency того же объекта; сумма в другой валюте записана как {"value": ..., "currency": ...}.
• В списках позиций, операций и событий облигаций опущены нулевые и пустые поля. Отсутствие поля означает ноль, «нет» или пусто.
• Инструмент можно назвать как угодно: тикером, FIGI, ISIN или UID — в любом параметре, который принимает инструмент. Если под одним тикером торгуются разные бумаги (T — это и Т-Технологии, и AT&T), сервер попросит уточнить в виде ТИКЕР_КЛАСС, например T_TQBR. По названию ищет find_instrument.
• Даты — в UTC. Дата без времени в to_date включает весь этот день.

Примеры запросов к ассистенту

• «Покажи мой портфель и общую доходность»
• «Какие дивиденды я получил за последний год?»
• «Найди облигации Газпрома и покажи купонный календарь»
• «Сравни P/E Сбера и ВТБ»
• «Дай сводку по SBER: фундаментал, динамика цены, консенсус аналитиков»
• «Построй RSI для AAPL за последние 3 месяца»
• «Какие у меня активные заявки?»

Лицензия

MIT