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 許可證。