SSI Stock Data MCP Server

Оглавление

• Оглавление

• 1. Введение

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

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

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

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

  • 3.3. Запуск Docker

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

• 5. Развитие

• 6. Лицензия

Related MCP server: Tushare_MCP

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.

• Электронная почта: нет данных