Cultura y Turismo: búsqueda de áreas escénicas de turismo cultural

Este servicio MCP se centra en la búsqueda de áreas escénicas de turismo cultural y ofrece capacidades de búsqueda de áreas escénicas de estándar nacional, pueblos y aldeas clave de turismo rural, restaurantes y alojamientos rurales, hoteles de estrellas y agencias de viajes de turismo emisor.

Sector: Información integral

Funciones principales

• Búsqueda de áreas escénicas de turismo cultural de estándar nacional

• Búsqueda de pueblos y aldeas clave de turismo rural

• Búsqueda de restaurantes, alojamientos rurales y hoteles de estrellas

• Búsqueda de agencias de viajes de turismo emisor

Related MCP server: Chinese Tourism Spots MCP Server

Notas de diseño del servicio

• El servicio utiliza el descubrimiento de áreas escénicas como punto de entrada y complementa los recursos de turismo rural, alojamiento y restauración, y agencias de viajes, para satisfacer escenarios de consulta de combinación de recursos de destinos.

• El servicio ofrece 4 herramientas de solo lectura; cada llamada a una herramienta accede únicamente a un Product ID.

• Los resultados con paginación se unifican en total y resultList.

• Las respuestas exitosas son automáticamente compatibles con el data de negocio de Gateway y con el stat/data interno.

• El tiempo de espera de las solicitudes se puede configurar mediante HANDAAS_REQUEST_TIMEOUT; el valor predeterminado es de 30 segundos.

Requisitos del entorno

• Python 3.10+

• Dependencias: mcp, python-dotenv, requests

Inicio rápido local

cd tourism-mcp-server
python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt
cp .env.example .env
python server/mcp_server.py streamable-http

La dirección predeterminada del servicio es http://127.0.0.1:8000/mcp. Admite stdio, sse y streamable-http.

Variables de entorno

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

Las credenciales reales solo deben guardarse en el .env local o en los secretos de despliegue.

Configuración de Cursor / Cherry Studio

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

Herramientas disponibles y Product IDs

Guía de selección de herramientas

• Si el usuario pregunta por áreas escénicas de nivel A, evaluación de áreas escénicas o entidades operadoras de áreas escénicas: use tourism_scenic_area_search.

• Si el usuario pregunta por aldeas clave, pueblos clave de turismo rural o el lote en el que fueron seleccionados: use tourism_countryside_search.

• Si el usuario pregunta por alojamientos rurales, alojamiento y restauración u hoteles de estrellas: use tourism_accommodation_search.

• Si el usuario pregunta por agencias de viajes de turismo emisor, licencias de agencias de viajes o tamaño de la empresa: use tourism_travel_agency_search.

Descripción detallada de las herramientas

1. tourism_scenic_area_search

Cuándo usarla: para descubrir áreas escénicas de estándar nacional por nombre, categoría o región, y verificar la información de evaluación y la entidad operadora.

Parámetros clave: taName admite búsqueda difusa; taCategory, la provincia/ciudad y taBatchNumber se utilizan para refinar la búsqueda; para la provincia del área escénica se utilizan nombres cortos como «Pekín» o «Guangdong»; pageSize máximo 50.

Resultado: devuelve el nombre del área escénica, la categoría, la región, el año de evaluación, la fecha de publicación, la dirección y la entidad operadora.

2. tourism_countryside_search

Cuándo usarla: para consultar los pueblos y aldeas clave de turismo rural de todo el país y el lote en el que fueron seleccionados.

Parámetros clave: se puede filtrar por nombre del pueblo o aldea, lote, provincia y ciudad; admite paginación.

Resultado: devuelve el nombre del pueblo o aldea, el número de certificado, la región, el año de evaluación, la fecha de publicación e información de imágenes.

3. tourism_accommodation_search

Cuándo usarla: para consultar restaurantes, alojamientos rurales, hoteles de estrellas y las empresas operadoras que hay detrás.

Parámetros clave: taType es el tipo de alojamiento; los valores multinivel de address usan «provincia, ciudad, distrito»; el formato de fecha es YYYY-MM-DD; el capital registrado se expresa en decenas de miles de yuanes.

Resultado: devuelve el nombre del alojamiento, el tipo, el número de certificado, el nombre de la empresa, el ID de la entidad, el representante legal, el capital registrado, la dirección y el estado operativo.

4. tourism_travel_agency_search

Cuándo usarla: para consultar las licencias de las agencias de viajes de turismo emisor, las empresas operadoras y el volumen de negocio.

Parámetros clave: se puede filtrar por nombre de la agencia, región, fecha de constitución, capital registrado y estado operativo; en el caso de los municipios directamente dependientes del gobierno central, se utilizan nombres cortos como «Shanghái» o «Pekín»; admite paginación.

Resultado: devuelve el nombre de la agencia en chino e inglés, la licencia, la entidad empresarial, el representante legal, el capital registrado, la facturación anual y las etiquetas de negocio.

Ejemplos de uso

Ejemplo 1: búsqueda de áreas escénicas

Buscar áreas escénicas de estándar nacional en Pekín cuyo nombre contenga «Palacio Imperial»; devolver la dirección del área escénica y la entidad operadora.

{
  "tool": "tourism_scenic_area_search",
  "arguments": {
    "taName": "故宫",
    "taProvince": "北京",
    "pageIndex": 1,
    "pageSize": 10
  }
}

Ejemplo 2: búsqueda de pueblos y aldeas clave de turismo rural

Consultar los pueblos y aldeas clave de turismo rural seleccionados en la provincia de Zhejiang.

{
  "tool": "tourism_countryside_search",
  "arguments": {
    "taProvince": "浙江省",
    "pageIndex": 1,
    "pageSize": 10
  }
}

Ejemplo 3: búsqueda de alojamientos rurales y hoteles

Encontrar alojamientos rurales en funcionamiento en Hangzhou y devolver la empresa operadora y la información de registro.

{
  "tool": "tourism_accommodation_search",
  "arguments": {
    "taType": "民宿",
    "address": "浙江省,杭州市",
    "operStatus": "存续",
    "pageIndex": 1,
    "pageSize": 10
  }
}

Ejemplo 4: búsqueda de agencias de viajes de turismo emisor

Consultar las agencias de viajes de turismo emisor de Shanghái y su información de licencias.

{
  "tool": "tourism_travel_agency_search",
  "arguments": {
    "address": "上海",
    "pageIndex": 1,
    "pageSize": 10
  }
}

Notas de uso

1. El límite inferior del intervalo de fecha de constitución y de capital registrado no debe ser mayor que el límite superior.

2. En address, los valores de región multinivel se separan con comas en inglés.

3. Todos los resultados de búsqueda se devuelven de forma unificada en total/resultList.

4. Cuando los valores de filtro no tienen coincidencias, se devuelve un resultado vacío válido; se puede reintentar tras reducir los criterios.

Verificación de pruebas

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

Las pruebas unitarias utilizan respuestas Mock; la verificación real se realiza invocando a HandaaS Integrator Gateway mediante el .env local.