Оглавление
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.
- Электронная почта: нет данных