Mistral Codestral

🚀 Mistral Codestral 代码服务站服务器

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

🚀 快速开始

安装步骤

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

   npm install
   

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

   cp .env.example .env
   

4. 构建项目：

   npm run build
   

启动服务器

npm start

✨ 主要特性

• 代码补全：使用 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

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

📚 详细文档

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 许可证。