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

6. Лицензия

Апач 2.0

Контакты/Поддержка

Если у вас возникли какие-либо проблемы или вам нужна поддержка, пожалуйста, создайте сообщение на GitHub.
Электронная почта: нет данных

SSI Stock Data MCP Server

Оглавление