Mistral MCP 서버 예제

이것은 Mistral과의 채팅을 위한 두 가지 도구를 제공하는 TypeScript 기반 MCP 서버입니다. 모델 컨텍스트 프로토콜(MCP) 과 함께 사용할 수 있는 서버를 만드는 방법을 보여주는 기본적인 예시입니다.

블로그 게시물

이 저장소는 Speakeasy의 블로그 게시물인 "Mistral을 위한 MCP 서버 구축" 의 일부입니다.

요구 사항

• Node.js(v20.17.10에서 테스트됨)
• 도구를 지원하는 MCP 클라이언트 입니다. Claude 데스크톱 애플리케이션 이나 Cline VSCode 확장 프로그램을 권장합니다.

미스트랄 API 키

Mistral AI 플랫폼과 상호 작용하려면 API 키가 필요합니다. mistral.ai 에 가입하면 API 키를 받으실 수 있습니다.

API 키를 환경 변수로 설정하세요. .env.example 파일의 복사본을 만들고 이름을 .env 로 바꾸세요.

지엑스피1

이제 Mistral API 키로 .env 파일을 업데이트하세요.

도구

이 서버는 두 가지 도구를 제공합니다.

텍스트 입력을 사용하여 Mistral과 채팅하려면 mistral_chat_text 도구를 사용하세요.

• 모델과 텍스트 입력 배열을 가져옵니다.
• Mistral에서 텍스트 응답을 반환합니다.

텍스트와 이미지 입력을 사용하여 Mistral과 채팅하려면 mistral_chat_image 도구를 사용하세요.

• 모델과 텍스트 및 이미지 입력 배열을 가져옵니다.
• 공개 URL에 호스팅된 이미지만 허용합니다.
• Mistral에서 텍스트 응답을 반환합니다.

개발

종속성 설치:

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

설치

Claude 데스크톱 앱과 함께 이 서버를 사용하려면 다음 서버 구성을 Claude 구성 파일에 추가하세요.

• MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

디버깅

MCP 서버는 표준 입출력 스트림(stdio)을 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

MCP Inspector는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.