Сервер MCP биржевых данных SSI

1. Введение

SSI Stock Data MCP — сервер Model Context Protocol (MCP) для получения внутридневных данных по акциям Вьетнама. Он позволяет помощникам и инструментам ИИ запрашивать внутридневные данные с использованием API SSI FastConnect программным и безопасным способом.

2. Особенности

[x] Список кодов акций по биржам
[x] Получить подробную информацию о биржевом коде
[x] Получить список кодов акций в корзине индекса
[x] Получить список индексных кодов
[x] Извлечение информации об открытии, максимуме, минимуме, закрытии, объеме и стоимости биржевого кода по данным каждого тика
[x] Получить информацию об открытии, максимуме, минимуме, закрытии, объеме и стоимости биржевого кода по дням
[x] Получить ежедневные результаты торговли композитного индекса
[x] Получить ежедневную торговую информацию по биржевому коду
[x] Поддержка контейнеризации Docker
[ ] Поддержка получения данных в реальном времени через потоковый адаптер (планируется)
[ ] Поддержка управления заказами и торговли через MCP (будущее рассмотрение)

3. Быстрый старт

3.1 Предпосылки

Питон 3.12+
uv (для быстрого управления зависимостями).
Docker (опционально, для контейнерного развертывания).
Убедитесь, что вы зарегистрировались на сервисе SSI FastConnect перед запуском этого сервера MCP. Вы можете зарегистрироваться на SSI FastConnect , чтобы получить свой идентификатор потребителя и секрет.

Установка через Smithery

Чтобы автоматически установить SSI Stock MCP Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @archiephan78/ssi-stock-mcp-server --client claude

3.2 Локальный запуск

Клонируйте репозиторий:

# Clone the repository $ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git

Настройте переменные среды

# Set environment variables (see .env.sample) FC_DATA_URL=https://fc-data.ssi.com.vn/ #optional FC_DATA_AUTH_TYPE=Bearer #optional FC_DATA_CONSUMER_ID=your_consumer_id FC_DATA_CONSUMER_SECRET=your_consumer_secret

Добавьте конфигурацию сервера в файл конфигурации клиента. Например, для Claude Desktop:

{ "mcpServers": { "SSIStockMCPServer": { "command": "uv", "args": ["--directory", "full-path", "run", "ssi-stock-mcp-server"], "env": { "FC_DATA_CONSUMER_ID": "id", "FC_DATA_CONSUMER_SECRET": "id", "FC_DATA_URL": "https://fc-data.ssi.com.vn/", "FC_DATA_AUTH_TYPE": "Bearer" } } } }

Перезапустите Claude Desktop, чтобы загрузить новую конфигурацию.
Теперь вы можете попросить Клода взаимодействовать с данными, используя естественный язык:
- "Chỉ số VN30 хом най có gì hot khong"
- "Получите объемную комнату, а затем запретите SSI, но нет"
- «так что лучше, чем SSI и VND, сейчас нет»
- "общее количество матчей с SSI в течение 1 месяца"

3.3. Запуск Docker

Запустите его с помощью готового образа (или вы можете собрать его самостоятельно):

$ docker run -p 8000:8000 -e FC_DATA_CONSUMER_ID=id -e FC_DATA_CONSUMER_SECRET=id ghcr.io/archiephan78/ssi-stock-mcp-server

Запуск с Docker в Claude Desktop:

{ "mcpServers": { "SSIStockMCPServer": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "FC_DATA_CONSUMER_ID", "-e", "FC_DATA_CONSUMER_SECRET", "ghcr.io/archiephan78/ssi-stock-mcp-server:latest" ], "env": { "FC_DATA_CONSUMER_ID": "your_username", "FC_DATA_CONSUMER_SECRET": "your_password" } } } }

Эта конфигурация передает переменные среды из Claude Desktop в контейнер Docker, используя флаг -e только с именем переменной и предоставляя фактические значения в объекте env .

4. Инструменты

Сервер MCP предоставляет инструменты:

Получить список ценных бумаг: get_securities_list()
Получить сведения о ценных бумагах: get_securities_details()
Получить индекс: get_index_components()
Получить индекс списка: get_index_list()
Получить ежедневные цены открытия, максимума, минимума, закрытия: get_daily_ohlc()
Получить внутридневное открытие, максимум, минимум, закрытие: get_intraday_ohlc()
Получить ежедневный индекс: get_daily_index()
Получить цену акций: get_stock_price()

Полную информацию об API см. в src/ssi_stock_mcp_server/server.py.

5. Развитие

Вклады приветствуются! Пожалуйста, откройте тему или отправьте запрос на извлечение, если у вас есть какие-либо предложения или улучшения.

Этот проект использует uv для управления зависимостями. Установите uv, следуя инструкциям для вашей платформы.

# Clone the repository $ git clone https://github.com/archiephan78/ssi-stock-mcp-server.git $ uv venv $ source .venv/bin/activate # On Unix/macOS $ .venv\Scripts\activate # On Windows $ uv pip install -e . # run test $ pytest