English Français العربية

ai.smithery/JunoJunHyun-festival-finder-mcp

السجل الرسمي الخرائط والسفر والطقس

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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>'
إعداد 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>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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=... 형식으로 요청하여 테스트할 수 있습니다.

الأسئلة الشائعة

ما هو ai.smithery/JunoJunHyun-festival-finder-mcp؟

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

كيف أثبّت ai.smithery/JunoJunHyun-festival-finder-mcp؟

يعمل كخادم بعيد. في 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>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ai.smithery/JunoJunHyun-festival-finder-mcp إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل ai.smithery/JunoJunHyun-festival-finder-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون ai.smithery/JunoJunHyun-festival-finder-mcp؟

ينشره JunoJunHyun. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.