스파이럴 MCP 서버

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

설치

지엑스피1

Related MCP server: Jira MCP Server

설정

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 유형 검증

• 로깅 : 문제 해결을 위한 자세한 디버그 로깅