Информационный сервис больших данных

Этот MCP-сервис предоставляет возможности поиска по ключевым словам компаний, поиска по всем новостным источникам, получения корпоративных и отраслевых новостей, отслеживания тем и мониторинга динамики компаний, помогая пользователям проводить отраслевые исследования, отслеживать горячие темы, анализировать корпоративное общественное мнение и управлять репутацией бренда.

Основные функции

• 🏢 Поиск по кратким названиям компаний и ключевым словам

• 🔍 Поиск по ключевым словам во всех новостных источниках

• 🏢 Запрос корпоративных новостей и общественного мнения

• 🏭 Поиск новостей по отраслям и направлениям

• 🎯 Отслеживание тем: политика, технологии, бренды и события

• 📊 Мониторинг деталей корпоративных новостей и статистики тональности

Related MCP server: industry-chain-mcp-server

Описание проектирования сервиса

• Сервис предоставляет 6 инструментов (Tool) в соответствии с реальными бизнес-сценариями, а не раскладывает инструменты по количеству вышестоящих API.

• Если пользователь указывает только краткое название компании, сначала используйте information_enterprise_search, чтобы получить полное название или стабильный ID.

• Инструменты поиска, отраслевых новостей и тем используют один и тот же Product ID для поиска по всем источникам, но сохраняют семантику разных сценариев.

• Результаты поиска от вышестоящего API разбиваются на страницы на уровне MCP с помощью pageIndex и pageSize: по умолчанию 20 записей на страницу, максимум 50.

• По умолчанию результаты поиска не содержат длинный текст; при установке includeContent=true можно ограничить длину каждого текста с помощью contentMaxChars.

• information_monitor использует параметр view для выбора деталей или статистики и за один вызов обращается только к одному Product ID.

• Внешний бизнес-слой всех ответов с постраничной выдачей содержит только total и resultList.

Требования к окружению

• Python 3.10+

• Зависимости: python-dotenv, requests, mcp

Быстрый локальный запуск

1. Перейдите в каталог проекта

cd information-mcp-server

2. Создайте виртуальное окружение и установите зависимости

python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt

3. Настройте переменные окружения

Скопируйте шаблон переменных окружения:

cp .env.example .env

Отредактируйте файл .env:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

HANDAAS_REQUEST_TIMEOUT — необязательная настройка, указывается в секундах, значение по умолчанию — 30.

4. Запустите Streamable HTTP-сервис

python server/mcp_server.py streamable-http

Адрес сервиса по умолчанию: http://localhost:8000/mcp.

Также можно использовать скрипт запуска:

./start_mcp_server.sh streamable-http

Поддерживаются три режима запуска: stdio, sse и streamable-http.

5. Настройка MCP в Cursor / Cherry Studio

{
  "mcpServers": {
    "information-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Установка и развертывание STDIO-версии

Замените {workdir} на абсолютный путь к information-mcp-server:

{
  "mcpServers": {
    "information-mcp-server": {
      "command": "{workdir}/mcp_env/bin/python",
      "args": [
        "{workdir}/server/mcp_server.py",
        "stdio"
      ]
    }
  }
}

INTEGRATOR_ID, SECRET_ID и SECRET_KEY можно получить после регистрации и активации коннектора на HandaaS. Реальные учетные данные должны храниться только в локальном файле .env или в секретах развертывания.

Доступные инструменты и Product ID

1. information_enterprise_search

Функция: поиск компаний-кандидатов по краткому названию, бренду, продукту или другим ключевым словам.

Основные параметры: matchKeyword — обязательный; pageIndex — по умолчанию 1; pageSize — по умолчанию 10, максимум 50.

Возвращаемое значение: total/resultList компаний-кандидатов. После подтверждения компании используйте полное название, ID компании или единый код социального кредита в инструментах корпоративных новостей и мониторинга.

2. information_search

Функция: поиск заголовков и текстов новостей по ключевым словам.

Основные параметры:

• matchKeyword (обязательный): ключевое слово поиска.

• pubDateBegin, pubDateEnd (необязательные): начальная и конечная даты публикации.

• pageIndex (необязательный): номер страницы, возвращаемой MCP, начиная с 1.

• pageSize (необязательный): количество записей на страницу, по умолчанию 20, максимум 50.

• includeContent (необязательный): возвращать ли текст новости, по умолчанию false.

• contentMaxChars (необязательный): максимальное количество символов на одну запись при возврате текста, по умолчанию 1000, диапазон 100–5000.

Возвращаемое значение: total и resultList; результаты могут содержать заголовок, источник, время публикации, ссылку на новость и текст, обрезанный при необходимости.

3. information_company_news

Функция: запрос деталей новостей и общественного мнения по указанной компании.

Основные параметры:

• matchKeyword (обязательный): название компании, ID компании, регистрационный номер или единый код социального кредита.

• keywordType (необязательный): тип идентификатора компании. Поддерживаются name, nameId, regNumber, socialCreditCode.

• pageIndex (необязательный): номер страницы, начиная с 1.

• pageSize (необязательный): количество записей на страницу, по умолчанию 50, максимум 50.

• sentimentLabel (необязательный): 0 — негативная, 1 — позитивная, 2 — нейтральная, 3 — неизвестная.

Возвращаемое значение: total и resultList; результаты могут содержать краткое описание новости, ссылку, источник, заголовок, время публикации, связанные компании и метку тональности.

4. information_industry_news

Функция: поиск новостей по ключевым словам отрасли, направления или сектора для отраслевых исследований и анализа рыночной динамики.

Основные параметры:

• matchKeyword (обязательный): ключевое слово отрасли, направления или сектора.

• pubDateBegin, pubDateEnd (необязательные): диапазон времени публикации.

• pageIndex, pageSize (необязательные): номер страницы и количество записей на страницу, pageSize максимум 50.

• includeContent, contentMaxChars (необязательные): переключатель возврата текста и максимальная длина текста.

Возвращаемое значение: total и resultList.

5. information_topic

Функция: отслеживание конкретных тем, таких как политика, технологии, бренды или горячие события.

Основные параметры:

• matchKeyword (обязательный): ключевое слово конкретной темы или события.

• pubDateBegin, pubDateEnd (необязательные): временной диапазон наблюдения за темой.

• pageIndex, pageSize (необязательные): номер страницы и количество записей на страницу, pageSize максимум 50.

• includeContent, contentMaxChars (необязательные): переключатель возврата текста и максимальная длина текста.

Возвращаемое значение: total и resultList.

6. information_monitor

Функция: мониторинг динамики корпоративных новостей с возможностью выбора представления деталей событий или статистики тональности.

Основные параметры:

• matchKeyword (обязательный): название компании, ID компании, регистрационный номер или единый код социального кредита.

• view (необязательный): details — детали новостных событий; statistics — распределение и динамика тональности. По умолчанию statistics.

• keywordType (необязательный): тип идентификатора компании.

• pageIndex, pageSize (необязательные): используются только в представлении details, pageSize максимум 50.

• sentimentLabel (необязательный): фильтр по тональности, используется только в представлении details.

Возвращаемое значение: представление деталей возвращает total и resultList; представление статистики возвращает бизнес-поля распределения и динамики тональности.

Сценарии использования

1. Идентификация компании: по краткому названию или бренду подтвердите полное название и стабильный идентификатор компании.

2. Поиск новостей: агрегация заголовков, источников, времени и ссылок всех новостей по ключевым словам.

3. Отраслевые исследования: отслеживание динамики по отраслям, направлениям и секторам.

4. Отслеживание тем: постоянное наблюдение за политикой, технологиями, брендами и горячими событиями.

5. Корпоративное общественное мнение: поиск новостей о компании с фильтрацией по категориям тональности.

6. Мониторинг динамики: анализ распределения и тенденций тональности корпоративных новостей.

7. Управление репутацией бренда: выявление репутационных рисков на основе деталей новостей и статистики тональности.

Примечания по использованию

1. Обработка кратких названий: если краткое название компании нельзя использовать для прямого запроса, сначала вызовите information_enterprise_search.

2. Выбор сценария: для корпоративного общественного мнения используйте information_company_news или information_monitor; для отраслевых исследований — information_industry_news.

3. Ограничения постраничной выдачи: pageIndex начинается с 1, pageSize должен быть от 1 до 50.

4. Управление текстом: по умолчанию informationText не возвращается; если нужен текст, явно установите includeContent=true.

5. Длина текста: contentMaxChars должен быть от 100 до 5000.

6. Метки тональности: 0 — негативная, 1 — позитивная, 2 — нейтральная, 3 — неизвестная.

7. Допустимые пустые результаты: при отсутствии совпадений по ключевым словам, времени или тональности может возвращаться total=0 и пустой resultList.

Примеры запросов

information_enterprise_search (поиск по ключевым словам компании)

1. Каким компаниям соответствует «Xiaomi»?

2. С помощью «Gree» найдите точное название компании и её ID.

information_search (полнотекстовый поиск новостей)

1. Найдите новости об искусственном интеллекте, только заголовки и источники.

2. Найдите новости о новых энергетических автомобилях и верните два коротких текста.

information_company_news (запрос корпоративных новостей)

1. Найдите последние корпоративные новости Xiaomi Technology Co., Ltd.

2. Просмотрите негативные общественные настроения по Gree Electric Appliances, Inc. of Zhuhai.

information_industry_news (поиск отраслевых новостей)

1. Найдите последние новости в сфере низковысотной экономики.

2. Какие последние отраслевые события в области гуманоидных роботов?

information_topic (отслеживание тем новостей)

1. Постоянно отслеживайте техническую тему больших моделей искусственного интеллекта.

2. Отслеживайте события, связанные с политикой обмена старых потребительских товаров на новые.

information_monitor (мониторинг динамики корпоративных новостей)

1. Отслеживайте распределение и динамику тональности общественного мнения по Xiaomi Technology Co., Ltd.

2. Просмотрите последние детали новостных событий по Beijing Jingdong Century Trading Co., Ltd.

Тестирование и проверка

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

Модульные тесты используют имитированные HTTP-ответы (Mock) и не обращаются к реальному информационному API HandaaS.