https://github.com/bsmi021/mcp-mistral-codestral
https://github.com/bsmi021/mcp-mistral-codestral
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/bsmi021/mcp-mistral-codestral
- Owner: bsmi021
- Created: 2025-01-18T20:03:14.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-05-05T08:43:40.000Z (5 months ago)
- Last Synced: 2025-05-08T22:56:35.683Z (5 months ago)
- Language: TypeScript
- Size: 10.7 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- mcp-index - Mistral Codestral - Provides code completion, bug fixing, and automated test generation capabilities using Mistral's Codestral API, supporting multiple programming languages and ensuring comprehensive input validation. (Developer Tools)
README
[](https://mseep.ai/app/bsmi021-mcp-mistral-codestral)
# Mistral Codestral MCP Server
An MCP server implementation for the Mistral Codestral API, providing code completion, bug fixing, and test generation capabilities.
## Features
- Code completion with Mistral's Codestral model
- Bug detection and fixing
- Automated test generation
- Support for multiple programming languages
- Rate limiting and error handling
- Resource access for code files
- Fill-in-the-Middle (FIM) completion support
- Comprehensive input validation using Zod schemas
## Installation
1. Clone this repository
2. Install dependencies:
```bash
npm install
```
3. Copy `.env.example` to `.env` and add your Mistral API key:
```bash
cp .env.example .env
```
4. Build the project:
```bash
npm run build
```
## Usage
Start the server:
```bash
npm start
```
### Configuration
Add your Mistral API key to the `.env` file:
```
MISTRAL_API_KEY=your_api_key_here
```
### Available Tools
#### code_completion
Process code for completion, bug fixing, or test generation:
Parameters:
- `code` (string, required): The code to process
- `language` (string, optional): Programming language
- `task` (string, required): One of:
- `"complete"`: Code completion
- `"fix"`: Bug fixing
- `"test"`: Test generation
- `"fim"`: Fill-in-the-Middle completion
### API Details
The server supports two main Mistral models:
- `codestral-latest`: Default model for code-related tasks
- `codestral-mamba-latest`: Alternative model with Mamba architecture
Features include:
- Automatic rate limiting (100ms minimum between requests)
- 30-second timeout for API calls
- Comprehensive error handling for API responses
- Response validation using Zod schemas
- Automatic extraction of code blocks from responses
- Debug logging for API interactions
## Development
Run in development mode with auto-reloading:
```bash
npm run dev
```
Run tests:
```bash
npm test
```
## Error Handling
The server implements comprehensive error handling:
- API errors are properly caught and formatted
- Rate limiting is implemented
- Input validation using Zod schemas
- Proper error propagation to clients
- Specific error messages for common issues:
- Authentication failures
- Rate limit exceeded
- Server errors
- Invalid input validation
## Resource Access
The server provides access to code files through the `file://code` resource URI, allowing integration with workspace files.
## License
MIT