Mistral Codestral

🚀 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 詳細

サーバーは 2 つの主要な Mistral モデルをサポートしています。

• codestral-latest：コード関連のタスクにデフォルトで使用されるモデル
• codestral-mamba-latest：Mamba アーキテクチャを採用した代替モデル

機能には以下が含まれます。

• 自動レート制限（リクエスト間の最小間隔 100ms）
• API 呼び出しの 30 秒タイムアウト
• 包括的な API 応答エラー処理
• Zod スキーマを使用した応答検証
• 応答からのコードブロックの自動抽出
• API インタラクションのデバッグログ記録

開発情報

開発モードで自動リロードして実行します。

npm run dev

テストを実行します。

npm test

エラー処理

サーバーは包括的なエラー処理を実装しています。

• API エラーのキャプチャとフォーマット
• レート制限の実装
• Zod スキーマを使用した入力検証
• クライアントへのエラーの伝播
• 一般的な問題に対する具体的なエラー情報の提供
  • 認証失敗
  • リクエストが制限を超えた
  • サーバーエラー
  • 入力検証が無効

リソースアクセス

サーバーは file://code リソース URI を通じてコードファイルへのアクセスを提供し、ワークスペースファイルとの統合をサポートしています。

📄 ライセンス

MIT