Mistral Codestral 代码服务站服务器

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

特性

• 使用 Mistral 的 Codestral 模型实现代码补全
• 支持错误检测与修复
• 自动生成测试代码
• 支持多种编程语言
• 实现速率限制和错误处理
• 提供对代码文件的资源访问
• 支持 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