mistral-mcp

Mistral AI 기능을 모든 MCP 클라이언트(Claude Code, Cursor, Zed, Windsurf, Claude Desktop)에 노출하는 MCP 서버

프랑스어 버전: README.fr.md

👁 version
👁 license
👁 node
👁 typescript
👁 mcp-spec
👁 tools
👁 resources
👁 prompts
👁 tests

목적

Mistral은 프랑스어, 코드, OCR, 조정, 오디오 및 에이전트 스타일 워크플로우를 위한 강력한 모델을 보유하고 있지만, 대부분의 MCP 지원 IDE는 Anthropic이나 OpenAI를 기본으로 사용합니다. mistral-mcp는 이러한 Mistral 기능을 깔끔한 MCP 인터페이스로 제공하여, 에이전트 루프를 다시 구축할 필요 없이 적절한 하위 작업을 적절한 모델로 라우팅할 수 있게 합니다.

이 저장소의 목표는 "또 하나의 얇은 래퍼"가 되는 것이 아닙니다. 명확한 스키마, 예측 가능한 출력, 전송 유연성 및 우수한 테스트 커버리지를 갖춘 강력하고 유지 관리 가능한 MCP 서버를 지향합니다.

Related MCP server: MCP Server TypeScript

현재 인터페이스 (v0.4.0)

도구 (22)

핵심 생성:

• mistral_chat

• mistral_chat_stream

• mistral_embed

• mistral_tool_call

• codestral_fim

비전 및 오디오:

• mistral_vision

• mistral_ocr

• voxtral_transcribe

• voxtral_speak

에이전트 및 분류기:

• mistral_agent

• mistral_moderate

• mistral_classify

파일 및 배치:

• files_upload

• files_list

• files_get

• files_delete

• files_signed_url

• batch_create

• batch_list

• batch_get

• batch_cancel

MCP 네이티브 유틸리티:

• mcp_sample - MCP 샘플링을 통해 클라이언트 모델에 생성 위임

리소스 (2)

• mistral://models - 허용된 별칭 및 라이브 모델 카탈로그

• mistral://voices - Voxtral TTS를 위한 라이브 음성 카탈로그

프롬프트 (6)

프랑스어 큐레이팅 프롬프트:

• french_invoice_reminder

• french_meeting_minutes

• french_email_reply

• french_commit_message

• french_legal_summary

영어 큐레이팅 프롬프트:

• codestral_review

프롬프트 열거형 인수는 completable()로 래핑되어 있어, MCP 클라이언트가 completion/complete를 통해 프롬프트 인수 완성을 호출할 수 있습니다.

주요 특징

• 모든 도구에 inputSchema, outputSchema 및 주석이 포함된 고수준 McpServer API

• 이중 전송 지원: 기본적으로 stdio, 원격 배포를 위한 Streamable HTTP

• 모든 곳에서 구조화된 출력: structuredContent 및 텍스트 대체

• mcp_sample을 통한 MCP 샘플링 지원

• 열거형 프롬프트 인수에 대한 프롬프트 완성 지원

• 나중에 추가된 것이 아니라 도구와 함께 등록된 리소스 및 프롬프트

• Mistral SDK 클라이언트의 재시도/백오프 및 요청 시간 초과

전송

Stdio

기본 모드입니다. Claude Code 및 대부분의 로컬 MCP 클라이언트가 사용하는 방식입니다.

node dist/index.js

Streamable HTTP

--http 또는 MCP_TRANSPORT=http로 활성화합니다.

MCP_TRANSPORT=http node dist/index.js

관련 환경 변수:

• MCP_HTTP_HOST - 기본값 127.0.0.1

• MCP_HTTP_PORT - 기본값 3333

• MCP_HTTP_PATH - 기본값 /mcp

• MCP_HTTP_TOKEN - 선택적 베어러 토큰

• MCP_HTTP_ALLOWED_ORIGINS - 선택적 쉼표로 구분된 허용 목록

• MCP_HTTP_STATELESS=1 - 상태 비저장 세션 모드

/healthz는 의도적으로 공개되어 있으며 MCP 서버에 접근하지 않습니다.

설치

git clone https://github.com/Swih/mistral-mcp.git
cd mistral-mcp
npm install
npm run build

API 키 설정:

export MISTRAL_API_KEY=your_key_here

또는 저장소 루트의 .env를 사용하세요. 절대 커밋하지 마십시오.

Claude Code에서 사용

claude mcp add mistral -- node /absolute/path/to/mistral-mcp/dist/index.js

예시 프롬프트:

이 PDF에 mistral_ocr을 사용한 다음, 추출된 텍스트에 french_meeting_minutes를 실행하세요.

개발

npm run dev
npm run build
npm run lint
npm test
npm run inspector

테스트 전략

현재 테스트 모음은 4개 계층에 걸쳐 148개의 테스트를 포함합니다:

1. 도구, 리소스, 프롬프트, 전송, 오디오, 에이전트, 파일, 배치 및 샘플링에 대한 단위 테스트

2. 도구 메타데이터 및 MCP 보장에 대한 계약 테스트

3. MISTRAL_API_KEY가 설정되었을 때 실제 Mistral API에 대한 라이브 API 테스트

4. 빌드된 서버에 대한 Stdio 엔드투엔드 테스트

MISTRAL_API_KEY가 없으면 로컬 기본값은 139개 통과 및 9개 게이트 라이브/stdio 테스트입니다.

프로젝트 레이아웃

mistral-mcp/
|-- src/
| |-- index.ts
| |-- transport.ts
| |-- tools.ts
| |-- tools-fn.ts
| |-- tools-vision.ts
| |-- tools-audio.ts
| |-- tools-agents.ts
| |-- tools-files.ts
| |-- tools-batch.ts
| |-- tools-sampling.ts
| |-- resources.ts
| `-- prompts.ts
|-- test/
|-- examples/
|-- .github/workflows/ci.yml
|-- package.json
`-- tsconfig.test.json

상태

v0.4.0 — 출시됨. v0.3.0 대비 전체 변경 사항은 CHANGELOG.md를 참조하세요:

• 공유 헬퍼, 라이브 모델 + 음성 카탈로그, 계약 테스트

• 비전 + OCR

• 오디오 전사 + 음성

• 에이전트 + 조정 + 분류

• 파일 + 배치 API

• Streamable HTTP 전송 + MCP 샘플링

• 프랑스어 큐레이팅 프롬프트 5개 + 영어 프롬프트 1개 + 프롬프트 인수 완성

예시

실행 가능한 스크립트는 examples/에 있습니다. examples/README.md를 참조하세요.

라이선스

MIT Copyright Dayan Decamp

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• codestral_fimA
• mistral_chatA
• mistral_ocrA
• mistral_visionA
• voxtral_transcribeA
• workflow_executeA
• workflow_interactA
• workflow_statusA