Hippycampus MCP Server

히피캠퍼스

OpenAPI 사양의 동적 로딩과 Langflow와의 통합을 지원하는 LangChain 기반 CLI 및 MCP 서버입니다.

필수 조건

• 파이썬 3.12.9
• UV 패키지 관리자
• Google AI Studio API 키
• Langflow(시각적 워크플로 생성용)

설치

지엑스피1

구성

Google AI Studio API 키

1. Google AI Studio 방문
2. 오른쪽 상단의 "API 키 생성"을 클릭하세요.
3. 생성된 키를 복사하여 환경 변수로 설정합니다.

애플리케이션 실행

CLI 모드(MCP 서버 없음)

MCP 서버 모드(SSE)

랭플로우 서버

Langflow를 시작하기 전에 MCP 서버가 실행 중인지 확인하세요.

1. 구성 요소 경로 환경 변수를 설정합니다.

2. Langflow 서버를 시작합니다(개발 모드를 위해 --dev를 추가하세요):

3. 브라우저를 열고 http://localhost:7860 으로 이동하세요.

Langflow에서 사용자 정의 구성 요소 사용

1. Langflow UI에서 사용자 지정 구성 요소를 찾으세요.
   • OpenApi 서비스: OpenAPI 사양을 로드하기 위한 서비스
   • Hippycampus MCP 서버: SSE를 통해 MCP 서버에 연결하기 위한 서버
2. 구성 요소를 구성합니다.
   • OpenApi 서비스: 테스트를 위해 https://raw.githubusercontent.com/APIs-guru/unofficial_openapi_specs/master/xkcd.com/1.0.0/openapi.yaml 을 사용하세요.
   • MCP 서버: http://localhost:8000/sse 사용하세요

시각적 가이드를 보려면 Screencast 데모를 참조하세요. Screencast 데모

공식 XKCD swagger 파일에 오류가 있어서 comic_id 필드를 정수 대신 숫자로 지정하고 있습니다. 테스트 폴더에 수정된 버전이 있습니다.

문제 해결

• 인증 오류: GOOGLE_API_KEY 올바르게 설정되었는지 확인하세요
• Langflow에 누락된 구성 요소: LANGFLOW_COMPONENTS_PATH 가 올바른 디렉터리를 가리키는지 확인하세요.
• 연결 문제: Langflow를 통해 연결하기 전에 MCP 서버가 실행 중인지 확인하세요.
• Langflow에 구성 요소가 나타나지 않으면 Langflow 서버를 다시 시작해 보세요.
• MCP/Langflow에서 실행하기 전에 cli를 사용하여 openapi_builder/spec_parser 및 에이전트 상호 작용 문제를 디버깅합니다.

특허

MIT 라이센스

저작권 (c) 2024 Ray Cromwell

본 소프트웨어 및 관련 문서 파일(이하 "소프트웨어")의 사본을 취득한 모든 사람에게 소프트웨어를 제한 없이 거래할 수 있는 권한을 무상으로 부여합니다. 여기에는 소프트웨어 사본을 사용, 복사, 수정, 병합, 게시, 배포, 하위 라이선스 및/또는 판매할 수 있는 권한이 포함되나 이에 국한되지 않으며, 소프트웨어가 제공된 사람에게도 이러한 권한을 부여합니다. 단, 다음 조건에 따라야 합니다.

위의 저작권 고지와 본 허가 고지는 소프트웨어의 모든 사본 또는 실질적인 부분에 포함되어야 합니다.

본 소프트웨어는 상품성, 특정 목적 적합성 및 비침해에 대한 보증을 포함하되 이에 국한되지 않는 명시적 또는 묵시적 보증 없이 "있는 그대로" 제공됩니다. 어떠한 경우에도 저작자 또는 저작권자는 본 소프트웨어 또는 본 소프트웨어의 사용 또는 기타 거래와 관련하여 발생하는 계약, 불법 행위 또는 기타 소송을 포함한 모든 청구, 손해 또는 기타 책임에 대해 책임을 지지 않습니다.