히피캠퍼스

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

필수 조건

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

설치

지엑스피1

구성

Google AI Studio API 키

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

export GOOGLE_API_KEY='your-api-key-here'

애플리케이션 실행

CLI 모드(MCP 서버 없음)

uv run hippycampus-cli

MCP 서버 모드(SSE)

uv run hippycampus-server --transport sse --port 8000

랭플로우 서버

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

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

# Get your current working directory
pwd
# Use the output to set the components path
export LANGFLOW_COMPONENTS_PATH="/output/from/pwd/langflow/components"

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

uv run langflow run

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

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

Langflow UI에서 사용자 지정 구성 요소를 찾으세요.
- OpenApi 서비스: OpenAPI 사양을 로드하기 위한 서비스
- Hippycampus MCP 서버: SSE를 통해 MCP 서버에 연결하기 위한 서버
구성 요소를 구성합니다.
- 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 라이센스

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

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