# Mistral MCP Server

A comprehensive MCP (Model Context Protocol) server providing full access to the Mistral AI API. This server enables AI assistants like Claude to interact with all Mistral AI capabilities including chat completion, embeddings, fine-tuning, agents, OCR, audio transcription, and more.

## Features

### Chat & Completion
- **Chat Completion** - Full chat with function calling, JSON mode, vision support
- **FIM Completion** - Fill-in-the-middle code completion with Codestral
- **Embeddings** - Generate text embeddings for semantic search
- **Agents Completion** - Run completions with pre-configured agents

### Model Management
- List all available models with capabilities
- Get detailed model information
- Delete fine-tuned models
- Update, archive, and unarchive fine-tuned models

### File Management
- Upload files for fine-tuning, batch processing, or OCR
- List, download, and delete files
- Generate signed URLs for file access

### Fine-Tuning
- Create fine-tuning jobs with customizable hyperparameters
- Monitor job status and progress
- Support for dry-run validation
- Cancel and start jobs

### Batch Processing
- Create batch jobs for bulk API calls
- Monitor job progress and status
- Support for chat, embeddings, and FIM endpoints

### Media Processing
- **OCR** - Extract text from documents and images
- **Content Moderation** - Check text and chat for safety issues
- **Classification** - Classify text with fine-tuned classifiers
- **Audio Transcription** - Transcribe audio with Voxtral

### Agents & Conversations (Beta)
- Create and manage agents with custom instructions
- Manage conversations with agents
- Full conversation history support

### Libraries (Beta)
- Create document libraries for RAG
- Upload and manage documents
- Share libraries with users and workspaces

## Installation

```bash
# Clone the repository
git clone https://github.com/firstcastsolutions/mistral-mcp-server.git
cd mistral-mcp-server

# Install dependencies
npm install

# Build the project
npm run build
```

## Configuration

Set the required environment variable:

```bash
export MISTRAL_API_KEY="your-mistral-api-key"
```

## Usage

### With Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "mistral": {
      "command": "node",
      "args": ["/path/to/mistral-mcp-server/dist/index.js"],
      "env": {
        "MISTRAL_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Standalone

```bash
export MISTRAL_API_KEY="your-api-key"
npm start
```

## Available Tools (40+)

- Chat completion, FIM, embeddings, agents
- Model management (list, get, delete)
- File management (upload, download, delete)
- Fine-tuning jobs
- Batch processing
- OCR, moderation, classification
- Audio transcription
- Agents and conversations (Beta)
- Document libraries (Beta)

## License

MIT - First Cast Solutions LLC