Mistral Codestral MCP 服务器

一个用于 Mistral Codestral API 的 MCP 服务器实现，提供代码补全、错误修复和测试生成功能。

功能特性

• 使用 Mistral 的 Codestral 模型进行代码补全
• 错误检测和修复
• 自动化测试生成
• 支持多种编程语言
• 速率限制和错误处理
• 代码文件的资源访问
• 支持中间填充 (FIM) 补全
• 使用 Zod schemas 进行全面的输入验证

安装

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=your_api_key_here

可用工具

code_completion

处理代码以进行补全、错误修复或测试生成：

参数：

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

API 详情

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

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

功能包括：

• 自动速率限制（请求之间至少 100 毫秒）
• API 调用 30 秒超时
• API 响应的全面错误处理
• 使用 Zod schemas 进行响应验证
• 从响应中自动提取代码块
• API 交互的调试日志记录

开发

以自动重新加载的开发模式运行：

npm run dev

运行测试：

npm test

错误处理

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

• API 错误被正确捕获和格式化
• 实现了速率限制
• 使用 Zod schemas 进行输入验证
• 正确的错误传播到客户端
• 针对常见问题的特定错误消息：
  • 身份验证失败
  • 超出速率限制
  • 服务器错误
  • 无效的输入验证

资源访问

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

许可证

MIT