English Français العربية

ai.smithery/JunoJunHyun-festival-finder-mcp

Registre officiel Cartes, voyage et météo

Discover festivals worldwide by location, date, and genre. Compare options with key details like d…

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http junojunhyun-festival-finder-mcp 'https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp' --header 'Authorization: <Bearer token for Smithery authentication>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "junojunhyun-festival-finder-mcp": {
            "type": "http",
            "url": "https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp",
            "headers": {
                "Authorization": "<Bearer token for Smithery authentication>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Festival-Finder-mcp
  2. Festival Finder (페스티벌 파인더)
  3. 🏗️ 아키텍처
  4. 🛠️ 시작하기

Festival-Finder-mcp

Festival Finder (페스티벌 파인더)

범용 AI 에이전트 '페스티벌 파인더'입니다. 핵심 로직과 플랫폼별 어댑터를 분리하여 카카오톡, 일반 웹사이트 등 다양한 플랫폼에 연결할 수 있도록 설계되었습니다. KOPIS(공연예술통합전산망) API를 사용하여 전국의 공연 및 축제 정보를 제공합니다.

🏗️ 아키텍처

이 프로젝트는 '핵심 엔진(Core Engine)'과 '연결 어댑터(Connection Adapters)'라는 두 가지 주요 부분으로 구성된 확장 가능한 구조를 따릅니다.

🧠 핵심 엔진: core_logic.py
  • 플랫폼에 독립적인 순수 비즈니스 로직입니다.
  • KOPIS API에서 데이터를 가져오고, 가공되지 않은 순수한 파이썬 데이터 형태로 반환하는 역할만 담당합니다.
  • 어떤 플랫폼에 연결되는지 전혀 알지 못하며, 어디서든 재사용이 가능합니다.
📞 연결 어댑터
  • 핵심 엔진을 다양한 외부 플랫폼에 연결하는 '플러그' 역할을 합니다.
  • 각 플랫폼의 고유한 요청/응답 형식을 처리하고, 핵심 엔진과 통신합니다.
  • kakao_server.py: 카카오 PlayMCP용 어댑터 서버입니다.
  • web_server.py: 일반 웹사이트나 앱을 위한 범용 API 어댑터 서버입니다.

🛠️ 시작하기

  1. 필요 라이브러리 설치
      pip install -r requirements.txt
Installing via Smithery

To install festival-finder-mcp automatically via Smithery:

npx -y @smithery/cli install @JunoJunHyun/festival-finder-mcp
  1. KOPIS API 키 설정 core_logic.py 파일을 열어 KOPIS_API_KEY 변수에 발급받은 본인의 API 키를 입력하세요.
  2. 어댑터 서버 실행 필요한 어댑터 서버를 터미널에서 실행합니다.
    • 카카오톡 연동 테스트 시:
        python kakao_server.py
      • ngrok을 http://localhost:5000에 연결하고, PlayMCP Endpoint에 [ngrok 주소]/kakao를 등록합니다.
    • 일반 웹 API 테스트 시:
        python web_server.py
      • 웹 브라우저나 다른 프로그램에서 http://localhost:5001/api/performances?stdate=... 형식으로 요청하여 테스트할 수 있습니다.

Questions fréquentes

Qu'est-ce que ai.smithery/JunoJunHyun-festival-finder-mcp ?

Discover festivals worldwide by location, date, and genre. Compare options with key details like d…

Comment installer ai.smithery/JunoJunHyun-festival-finder-mcp ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http junojunhyun-festival-finder-mcp 'https://server.smithery.ai/@JunoJunHyun/festival-finder-mcp/mcp' --header 'Authorization: <Bearer token for Smithery authentication>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour ai.smithery/JunoJunHyun-festival-finder-mcp ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

ai.smithery/JunoJunHyun-festival-finder-mcp est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient ai.smithery/JunoJunHyun-festival-finder-mcp ?

Il est publié par JunoJunHyun. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.