Moex

by prikotov

428 downloads
Not rated
GitHub

About

Moex is an MCP (Model Context Protocol) server that provides tools to access data from the Moscow Exchange Information System (ISS). Built with Symfony and the logiscape/mcp-sdk-php library, it is intended for developers who want to integrate MOEX market data into AI assistants…

Details

Author
prikotov
Downloads
428
Categories
Other

- Retrieve security specifications from ISS MOEX
- Show Moscow Exchange indices containing a security
- Get aggregated trading results for a security
- Provide current trade data for a security
- Built on Symfony and MCP SDK for PHP
- Supports local, Docker, and Podman deployment

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Moex
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Configure your MCP client to run the Moex server using Docker via the command: docker run -i --rm prikotov/moex-mcp-server:latest bin/server. Alternatively, run locally with bin/server or php bin/console app:mcp-server. The server then lists available tools and allows calling each one.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "moex": {
            "moex": {
                "command": "docker",
                "args": [
                    "run",
                    "-i",
                    "--rm",
                    "prikotov/moex-mcp-server:latest",
                    "bin/server"
                ]
            }
        }
    }
}

McpServers

{
    "moex": {
        "command": "docker",
        "args": [
            "run",
            "-i",
            "--rm",
            "prikotov/moex-mcp-server:latest",
            "bin/server"
        ]
    }
}

Сервер MCP для Московской биржи

Проект содержит консольное приложение на базе Symfony, реализующее сервер MCP (Model Context Protocol).
Сервер предоставляет инструменты для работы с данными информационной системы Московской биржи (ISS).

Сервер использует библиотеку logiscape/mcp-sdk-php

Конфигурация

{
  "mcpServers": {
    "moex": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "prikotov/moex-mcp-server:latest", "bin/server"]
    }
  }
}

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

- get_security_specification — возвращает спецификацию указанной ценной бумаги из ISS МОEX;
- get_security_indices — показывает индексы Московской биржи, в которые включена бумага;
- get_security_aggregates — выводит агрегированные итоги торгов по инструменту за выбранную дату;
- get_security_trade_data — предоставляет текущие данные о торгах по инструменту;

Информация для разработчиков

Требования

- PHP версии 8.3 и выше;
- Composer.

Приложение можно запустить как локально, так и в Docker.

Установка

Склонируйте репозиторий и установите зависимости:

composer install

Запуск

Локально

bin/server

Либо традиционным способом:

php bin/console app:mcp-server

Либо с помощью podman:

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

Сервер выводит список доступных инструментов и позволяет вызывать каждый из них. Проверить можно с помощью:

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

Опция --via позволяет выбрать способ запуска сервера (console, podman или docker). По умолчанию используется console.

Docker (Podman)

В проекте присутствуют Dockerfile и compose.yaml. Чтобы собрать и запустить контейнер, выполните:

podman build -t moex-mcp-server .

Тесты

./bin/phpunit

Или

podman-compose run --rm moex-mcp-server bin/phpunit

Тесты подключают клиента к серверу и вызывают его инструменты.

Структура проекта

- src/ — исходный код приложения;
- src/Tool — исходный код Tools;
- bin/ — консольные скрипты;
- config/ — конфигурация Symfony;
- tests/ — интеграционные тесты.
- var/log — логи приложения.

Лицензия

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.