Kultur- und Tourismus: Suche nach Tourismusattraktionen

Dieser MCP-Dienst konzentriert sich auf die Suche nach Tourismusattraktionen und bietet Suchfunktionen für nationale Standard-Attraktionen, wichtige Dörfer und Gemeinden im ländlichen Tourismus, Gastronomie und Pensionen, Sternehotels sowie Reisebüros für Auslandsreisen.

Zugehöriger Bereich: Allgemeine Informationen

Hauptfunktionen

• Suche nach nationalen Standard-Tourismusattraktionen

• Suche nach wichtigen Dörfern und Gemeinden für den ländlichen Tourismus

• Suche nach Gastronomie, Pensionen und Sternehotels

• Suche nach Reisebüros für Auslandsreisen

Related MCP server: Chinese Tourism Spots MCP Server

Hinweise zum Servicedesign

• Der Dienst nutzt die Entdeckung von Attraktionen als Einstieg und ergänzt Ressourcen aus ländlichem Tourismus, Unterkünften, Gastronomie und Reisebüros, um Szenarien mit kombinierten Abfragen von Zielressourcen abzudecken.

• Der Dienst bietet 4 schreibgeschützte Tools; ein einzelner Tool-Aufruf greift nur auf eine Produkt-ID zu.

• Die Paginierungsergebnisse werden einheitlich in total und resultList zusammengeführt.

• Erfolgreiche Antworten sind automatisch mit den beiden Formaten Gateway-Geschäftsdaten data und internem stat/data kompatibel.

• Das Anforderungszeitlimit kann über HANDAAS_REQUEST_TIMEOUT konfiguriert werden, Standard sind 30 Sekunden.

Systemanforderungen

• Python 3.10+

• Abhängigkeiten: mcp, python-dotenv, requests

Lokaler Schnellstart

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

Standardadresse des Dienstes: http://127.0.0.1:8000/mcp. Unterstützt werden stdio, sse und streamable-http.

Umgebungsvariablen

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

Echte Anmeldeinformationen dürfen nur in der lokalen .env-Datei oder in Bereitstellungsschlüsseln gespeichert werden.

Cursor / Cherry Studio Konfiguration

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

Verfügbare Tools und Produkt-IDs

Tool-Auswahlhilfe

• Wenn Benutzer nach Attraktionen der Stufe A, Attraktionsbewertungen oder Betreibern von Attraktionen fragen: Verwenden Sie tourism_scenic_area_search.

• Wenn Benutzer nach wichtigen Dörfern, Gemeinden oder Aufnahmebatchen für ländlichen Tourismus fragen: Verwenden Sie tourism_countryside_search.

• Wenn Benutzer nach Pensionen, Gastronomie/Unterkünften oder Sternehotels fragen: Verwenden Sie tourism_accommodation_search.

• Wenn Benutzer nach Reisebüros für Auslandsreisen, Reisebürolizenzen oder Unternehmensgröße fragen: Verwenden Sie tourism_travel_agency_search.

Detaillierte Tool-Beschreibungen

1. tourism_scenic_area_search

Wann verwenden: Entdecken Sie nationale Standard-Attraktionen nach Name, Kategorie oder Region und prüfen Sie Bewertungsinformationen und Betreiber.

Wichtige Parameter: taName unterstützt die unscharfe Suche; taCategory, Provinz/Stadt und taBatchNumber dienen der weiteren Filterung; für die Provinz der Attraktion werden Kurznamen wie „Peking" oder „Guangdong" verwendet; pageSize maximal 50.

Rückgabebeschreibung: Gibt Name der Attraktion, Kategorie, Region, Bewertungsjahr, Veröffentlichungsdatum, Adresse und Betreiber zurück.

2. tourism_countryside_search

Wann verwenden: Fragen Sie wichtige Dörfer und Gemeinden des nationalen ländlichen Tourismus sowie deren Aufnahmebatchen ab.

Wichtige Parameter: Filterung nach Dorf-/Gemeindenamen, Charge, Provinz und Stadt möglich; Paginierung wird unterstützt.

Rückgabebeschreibung: Gibt Dorf-/Gemeindenamen, Zertifikatsnummer, Region, Bewertungsjahr, Veröffentlichungsdatum und Bildinformationen zurück.

3. tourism_accommodation_search

Wann verwenden: Fragen Sie Gastronomie, Pensionen, Sternehotels und die dahinterstehenden Betreiberunternehmen ab.

Wichtige Parameter: taType ist der Unterkunftstyp; bei address werden mehrstufige Werte als „Provinz,Stadt,Landkreis" angegeben; das Datumsformat ist JJJJ-MM-TT; das registrierte Kapital wird in Zehntausend Yuan angegeben.

Rückgabebeschreibung: Gibt Namen der Unterkunft, Typ, Zertifikatsnummer, Firmennamen, Betreiber-ID, gesetzlichen Vertreter, registriertes Kapital, Adresse und Geschäftsstatus zurück.

4. tourism_travel_agency_search

Wann verwenden: Fragen Sie Lizenzen, Betreiberunternehmen und Geschäftsgröße von Reisebüros für Auslandsreisen ab.

Wichtige Parameter: Filterung nach Reisebüroname, Region, Gründungsdatum, registriertem Kapital und Geschäftsstatus möglich; für regierungsunmittelbare Städte werden Kurznamen wie „Shanghai" oder „Peking" verwendet; Paginierung wird unterstützt.

Rückgabebeschreibung: Gibt den Namen des Reisebüros auf Chinesisch und Englisch, Lizenz, Unternehmenseinheit, gesetzlichen Vertreter, registriertes Kapital, Jahresumsatz und Geschäftskennzeichnungen zurück.

Anwendungsbeispiele

Beispiel 1: Attraktionen suchen

Suchen Sie nach nationalen Standard-Attraktionen in Peking, deren Name „Verbotene Stadt" enthält, und geben Sie Adresse und Betreiber der Attraktion zurück.

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

Beispiel 2: Wichtige Dörfer und Gemeinden für ländlichen Tourismus suchen

Fragen Sie die in der Provinz Zhejiang aufgenommenen wichtigen Dörfer und Gemeinden für ländlichen Tourismus ab.

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

Beispiel 3: Pensionen und Hotels suchen

Finden Sie in Hangzhou aktive Pensionen und geben Sie Betreiber- und Registrierungsinformationen zurück.

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

Beispiel 4: Reisebüros für Auslandsreisen suchen

Fragen Sie Reisebüros für Auslandsreisen in Shanghai und deren Lizenzinformationen ab.

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

Wichtige Hinweise zur Nutzung

1. Die Untergrenze des Intervalls für Gründungsdatum und registriertes Kapital darf die Obergrenze nicht überschreiten.

2. Bei address werden mehrstufige Regionen durch englische Kommas getrennt.

3. Alle Suchergebnisse geben einheitlich total/resultList zurück.

4. Wenn keine Übereinstimmung für den Filterwert gefunden wird, wird ein gültiges leeres Ergebnis zurückgegeben; Sie können die Bedingungen reduzieren und es erneut versuchen.

Test und Validierung

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

Die Komponententests verwenden Mock-Antworten; die echte Validierung erfolgt über den Aufruf des HandaaS Integrator Gateway über die lokale .env-Datei.