Skip to main content
Glama
diekinari

ru-finance

by diekinari
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

ru-finance

MCP-сервер с данными Московской биржи и Банка России + доменная аналитика портфеля.

Python MCP Транспорты

Подключается к Claude (Desktop / Code) и любым MCP-клиентам — локально через stdio или как remote-сервис по HTTP. Даёт котировки, метрики облигаций, ставки ЦБ, ожидания по ставке из G-кривой ОФЗ и готовые отчёты по портфелю.

NOTE

Серверgeneric и не хранит личных данных — бумаги и портфель передаются параметрами, его можно безопасно хостить и делиться. Он отдаёт числа; интерпретация остаётся за агентом (см. AGENTS.md). Данные с задержкой ~15 мин; это не инвестиционная рекомендация.

Возможности

  • MOEX — котировки, история, свечи, дивиденды; запасной доступ к любому из ~252 эндпоинтов ISS.

  • Облигации — цена, YTM, дюрация (Маколея и модифицированная), сценарии дохода при сдвиге ставки, реальная доходность.

  • Банк России — ключевая ставка, RUONIA (+ срочная кривая), MIACR, курсы валют, драгметаллы, ЗВР.

  • Ожидания по ставке — сигналы из G-кривой ОФЗ (наклон, спреды, форварды, метка cuts/hikes/flat) и точная NSS-модель MOEX для доходности на любом сроке.

  • Портфель — снимок (стоимость, P&L, распределение, дюрация, денежный поток), what-if по ставке, календарь выплат, лидеры/аутсайдеры.

Всего 22 инструмента — полный справочник в docs/TOOLS.md.

Related MCP server: moex-mcp

Быстрый старт

Требуется Python 3.11+ и сетевой доступ к iss.moex.com и cbr.ru.

git clone https://github.com/diekinari/ru-finance-mcp.git
cd ru-finance-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
python -m ru_finance.mcp_server        # запуск (stdio)

Подключение из Claude

# Claude Code — локально
claude mcp add ru-finance -- /путь/.venv/bin/python -m ru_finance.mcp_server

Claude Desktop — добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "ru-finance": {
      "command": "/путь/.venv/bin/python",
      "args": ["-m", "ru_finance.mcp_server"]
    }
  }
}

Remote-режим (HTTP)

Чтобы подключаться по URL (например, за nginx с TLS):

MCP_TRANSPORT=streamable-http MCP_HOST=127.0.0.1 MCP_PORT=8000 \
  python -m ru_finance.mcp_server
# эндпоинт: http://127.0.0.1:8000/mcp
claude mcp add --transport http ru-finance https://<домен>/mcp
IMPORTANT

Хост должен иметь сетевой доступ кiss.moex.com и cbr.ru. Публичный URL стоит защитить токеном авторизации. Полный гайд по деплою (systemd + nginx + TLS + токен) — готовится в docs/DEPLOY.md.

Документация

Файл

Назначение

docs/TOOLS.md

Полный справочник инструментов: входы, выходы, примеры

AGENTS.md

Как ИИ-ассистенту правильно пользоваться сервером

Как устроено

Слой

Назначение

moex (aioboy)

транспорт и парсинг ISS Московской биржи

cbrapi

данные веб-сервисов Банка России

ru_finance/

доменный слой: резолв бумаг, нормализация, облигационная математика, G-кривая, отчёты по портфелю

FastMCP

публикация инструментов по stdio / streamable-http

WARNING

Образовательный инструмент. Данные бесплатные, с задержкой, возможны пропуски и ошибки. Не является индивидуальной инвестиционной рекомендацией — решения принимаете вы.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

  • china-market-intelligence-mcpOAuth
    com.thenextgennexus

    MCP server giving AI agents one-connection access to China A-share market intelligence: financials,

    FinanceResearch & Data
    2
  • AIsa FinanceAOAuth
    one.aisa

    Your agent needs markets — prices and fundamentals for listed companies, the filings behind them, crypto, and what the prediction markets put the odds at. **What you can ask for** • "Pull this company's income statement, cash flow and balance sheet for the last 8 quarters." • "What did insiders buy or sell, and when?" • "Snapshot prices for these 50 tickers, then the OHLC history for the three that moved." • "What are the current odds on this event across Kalshi and Polymarket?" • "Screen for companies matching these financial criteria." **How to use it** Point any MCP client at https://mcp.aisa.one/finance/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: prices and snapshots, income statements, balance sheets and cash flows, metrics and ratios, earnings and analyst estimates, filings and line-item search, insider trades, macro interest rates, news, a screener; CoinGecko spot prices, market tables, OHLC, per-venue tickers and trending; Kalshi and Polymarket markets and trades; plus EDINET filings for Japan. **Why this rather than the source** Equities, crypto and event markets behind one account, so a cross-asset question is one conversation. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the number here, then ask the same agent what X is saying about the ticker today — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/marketpulse/mcp · /crypto-market-data/mcp · /prediction-market-data/mcp · /stock-pulse/mcp for one slice each.

    CryptocurrencyFinance
    541
  • AIsa EquitiesAOAuth
    one.aisa

    Your agent needs company financials it can compute on — statements, ratios, earnings, estimates, filings and insider activity as structured data, not a PDF. **What you can ask for** • "Give me 8 quarters of income statement, balance sheet and cash flow for this ticker." • "What do analysts estimate for next quarter, and how did the last four surprise?" • "Find this exact line item across every filing." • "Who bought or sold as an insider in the last 90 days?" • "Screen for profitable companies under this valuation with growing revenue." **How to use it** Point any MCP client at https://mcp.aisa.one/marketpulse/mcp and sign in with OAuth — there is no key to create or paste. 21 tools: prices and snapshots, income statements, balance sheets, cash-flow statements, financial metrics and snapshots, earnings, analyst estimates, company facts, filings and filing items, line-item search, a screener, insider trades, macro interest rates, news, plus EDINET documents and filing digests for Japanese issuers. **Why this rather than the source** Statements as fields you can compute on, and a screener in the same place. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the fundamentals here, then ask the same agent what social is saying about the ticker — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.

    FinanceResearch & Data
    261
  • openmm-mcpA
    io.github.QBT-Labs

    MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents

    Finance
    1513

Related MCP Servers

  • FinClaw

    IlyasFardaouix
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server that provides AI agents with financial tools including real-time quotes, backtesting, technical analysis, and multi-exchange data via a simple CLI interface.
    1
    MIT

  • moex-mcp

    cyberash-dev
    A
    license
    B
    quality
    D
    maintenance
    Provides access to Moscow Exchange data including quotes, trade history, candles, securities info, indices, and currency rates. Enables AI assistants to query financial market data through natural language.
    20
    7 npm
    MIT

  • FinMCP

    gigabytejayesh
    A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that enables AI agents to query real-time financial data including stock quotes, market indices, company fundamentals, and portfolio tracking.
    MIT

  • AkTools Pro MCP Server

    tchivs
    A
    license
    B
    quality
    C
    maintenance
    An enhanced MCP server that provides financial data and analysis tools for stocks, crypto, precious metals, and more, empowering AI agents with professional financial intelligence, including backtesting, ASCII charts, and simulated portfolios.
    58
    6
    MIT