Mistral Codestral

🚀 Mistral Codestral 代码服务站服务器

Mistral Codestral 代码服务站服务器是一个为 Mistral Codestral API 实现的 MCP 服务器，具备代码补全、错误修复和测试生成等实用功能，能有效提升代码编写效率。

✨ 主要特性

• 代码补全：借助 Mistral 的 Codestral 模型实现代码补全。
• 错误检测与修复：支持对代码中的错误进行检测和修复。
• 测试代码自动生成：可自动生成测试代码，减轻测试编写负担。
• 多语言支持：支持多种编程语言，满足不同开发需求。
• 速率限制与错误处理：实现速率限制和错误处理，保障服务稳定。
• 代码文件资源访问：提供对代码文件的资源访问。
• FIM 补全功能：支持 Fill-in-the-Middle (FIM) 补全功能。
• 全面输入验证：使用 Zod 架构进行全面输入验证。

📦 安装指南

1. 克隆此仓库。
2. 安装依赖项：

npm install

3. 复制 .env.example 到 .env 并添加你的 Mistral API 密钥：

cp .env.example .env

4. 构建项目：

npm run build

💻 使用示例

基础用法

启动服务器：

npm start

配置

将你的 Mistral API 密钥添加到 .env 文件中：

MISTRAL_API_KEY=你的_API_密钥_此处

可用工具

code_completion

处理代码以实现补全、修复或生成测试： 参数：

• code (字符串，必需)：要处理的代码
• language (字符串，可选)：编程语言
• task (字符串，必需)：其中一个：
  • "complete"：代码补全
  • "fix"：错误修复
  • "test"：测试生成
  • "fim"：中间插入补全

📚 详细文档

API 细节

服务器支持两个主要的 Mistral 模型：

• codestral-latest：默认用于代码相关任务的模型
• codestral-mamba-latest：采用 Mamba 架构的替代模型

功能包括：

• 自动速率限制（请求间最小 100ms）
• API 调用 30 秒超时
• 全面的 API 响应错误处理
• 使用 Zod 架构进行响应验证
• 自动生成代码块从响应中提取
• 对 API 交互进行调试日志记录

开发信息

以开发模式运行，自动重载：

npm run dev

运行测试：

npm test

错误处理

服务器实现全面的错误处理：

• 捕获并格式化 API 错误
• 实现速率限制
• 使用 Zod 架构进行输入验证
• 向客户端传播错误
• 为常见问题提供具体错误信息：
  • 认证失败
  • 请求超出限制
  • 服务器错误
  • 输入验证无效

资源访问

服务器通过 file://code 资源 URI 提供对代码文件的访问，支持与工作区文件集成。

📄 许可证

本项目采用 MIT 授权协议。