스파이럴 MCP 서버

이는 Python을 사용하여 Spiral API를 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. Spiral 언어 모델과 상호 작용하기 위한 표준화된 인터페이스를 제공합니다.

설치

지엑스피1

설정

1. 가상 환경을 만들고 활성화하세요.

2. 종속성 설치:

3. 루트 디렉토리에 .env 파일을 만들고 Spiral API 키를 추가하세요.

https://app.spiral.computer/api 에서 API 키를 받을 수 있습니다.

서버 실행

서버를 시작합니다:

서버는 기본적으로 3000번 포트에서 실행됩니다. PORT 환경 변수를 설정하여 포트를 변경할 수 있습니다.

도구 테스트

MCP 도구를 직접 테스트하려면:

이렇게 하면 사용 가능한 모든 도구에 대한 테스트를 실행하여 기능을 검증할 수 있습니다.

MCP 도구

서버는 4가지 강력한 MCP 도구를 구현합니다.

리스트_모델

사용 가능한 모든 Spiral 모델을 해당 기능과 메타데이터와 함께 나열합니다.

응답 예시:

생성하다

지정된 나선형 모델을 사용하여 텍스트를 생성합니다.

매개변수:

• model : 사용할 Spiral 모델의 ID 또는 슬러그
• prompt : 생성할 입력 텍스트

예:

파일에서 생성

파일에서 입력받은 Spiral 모델을 사용하여 텍스트를 생성합니다. 대용량 문서를 처리하거나 일관된 서식을 유지하는 데 유용합니다.

매개변수:

• model : 사용할 Spiral 모델의 ID 또는 슬러그
• file_path : 입력으로 사용할 파일의 경로

예:

URL에서 생성

URL을 입력받아 나선형 모델을 사용하여 텍스트를 생성합니다. 이 도구는 웹 페이지에서 기사 콘텐츠를 자동으로 추출할 수 있습니다.

매개변수:

• model : 사용할 Spiral 모델의 ID 또는 슬러그
• url : 콘텐츠를 가져올 URL
• extract_article : 기사 내용을 추출할지 아니면 전체 HTML을 사용할지 여부(기본값: true)

예:

오류 처리

서버는 다음을 포함한 다양한 오류 사례를 처리합니다.

• 잘못된 API 키
• 모델을 찾을 수 없습니다
• 입력이 너무 길어요
• 요금 제한을 초과했습니다
• URL 가져오기 실패
• 파일 읽기 오류
• 서버 오류
• 요청 시간 초과

각 오류는 문제를 진단하는 데 도움이 되는 명확한 오류 메시지를 반환합니다.

환경 변수

• SPIRAL_API_KEY : Spiral API 키(필수)
• PORT : 서버 포트(선택 사항, 기본값은 3000)
• TIMEOUT : 요청 시간 초과(초) (선택 사항, 기본값은 30)

특징

• 강력한 오류 처리 : 모든 작업에 대한 포괄적인 오류 처리 및 로깅
• 기사 추출 : 웹 페이지에서 기사 콘텐츠를 스마트하게 추출
• 유연한 입력 소스 : 텍스트, 파일 및 URL을 입력으로 지원
• 비동기 작업 : 모든 작업은 더 나은 성능을 위해 비동기적입니다.
• 유형 안전성 : 모든 매개변수에 대한 전체 Pydantic 유형 검증
• 로깅 : 문제 해결을 위한 자세한 디버그 로깅