Universal Mistral MCP Adapter

Mistr. Agent

Mistral AI モデル向けの自律型 MCP クライアントで、Model Context Protocol (MCP) 統合により、ローカル環境とウェブ環境全体での AI 駆動型タスク実行を実現します。

概要

Agentic MCP クライアントは、Mistral 言語モデルを Model Context Protocol (MCP) を通じて実世界の機能に接続する最新のインターフェースを提供します。ウェブ検索からローカルファイルの操作、システムコマンドの実行まで、異なる環境全体で複数のツールを調整することで、LLM が自律的にタスクを実行できるようにします。

基本的なチャットインターフェースとは異なり、このエージェントは複数ステップの操作全体でコンテキストを維持でき、エラーに遭遇した場合に自己修正でき、ツールアクセスを制御するためのセキュリティメカニズムを提供します。実用的な現実世界のアプリケーションを備えた真のエージェント AI 体験を実現します。

スクリーンショット

ツール呼び出し統合	ダークモードインターフェース

チャット履歴インターフェース	ツールリストドロップダウン

コア機能

🧠 自律型タスク実行

• コンテキスト保守を伴う複数ターン、複数ツールのタスク完了
• パラメータが正しくない場合のツール使用の自己修正
• 詳細なフィードバックを伴う高度なエラーハンドリング
• 会話ターン全体にわたるツール状態管理

🛠️ ツール統合フレームワーク

• MCP サーバーとその機能の動的読み込み
• 自動ツール検出と機能ネゴシエーション
• 複数サーバー間のインテリジェントなツールルーティング
• パラメータ検証を備えた拡張ツール説明

🔒 セキュリティと制御

• 機密操作に対するヒューマンインザループ承認
• ツールアクセスのレート制限
• 潜在的に危険な操作の検出
• すべてのツール使用に対する詳細な監査ログ

💻 システム統合

• ターミナルコマンド実行とプロセス管理
• ローカルファイルシステム操作（読み取り、書き込み、リスト、検索、編集）
• ファイルコンテンツの分析と操作
• クロスプラットフォーム対応

🌐 外部サービス

• Perplexity AI 統合によるウェブ検索
• MCP を通じた他の API サービスへの拡張性
• 天気情報取得
• カスタムサービス統合の追加能力

システム要件

• インターネット接続: Mistral モデルと Perplexity 検索への API アクセスに必須
• Node.js: v16.x 以上
• RAM: 最小 4GB（8GB 推奨）
• ストレージ: インストール用 500MB

アプリケーションは、Mistral 8B のような小規模モデルへのアクセスがある場合、ローカルで実行できます。

サポートされているモデル

すべての Mistral チャットモデルがサポートされています。アプリケーションは以下でテストおよび検証されています。

• Mistral 8B
• Mistral Large

設定で好みのモデルを構成できます。

アーキテクチャ概要

Agentic MCP クライアントはモジュール式アーキテクチャを実装しています。

• MCP アダプター: Mistral モデルを MCP サーバーに接続するコア調整レイヤー
• サーバーマネージャー: 機能ネゴシエーション機能を備えた複数のツールサーバーへの接続を処理
• ツールマネージャー: 拡張スキーマ情報を使用したツールの登録と検証
• セキュリティマネージャー: 承認ワークフローと検証を使用したツールアクセスの制御
• 最新 UI: 会話管理を備えた React/Next.js インターフェース

インストール

GitHub から

1. リポジトリをクローン

   git clone https://github.com/itisaevalex/mistr-agent.git
   cd mistr-agent
   

2. 依存関係をインストール

   npm install
   

3. API キーを設定

   # Create a .env.local file
   cp .env.example .env.local
   # Edit the file with your API keys
   

4. 開発サーバーを起動

   npm run dev
   

5. アプリケーションへアクセス ブラウザで http://localhost:3000 を開く

MCP サーバー構成

エージェントは Model Context Protocol (MCP) サーバーに接続して機能を拡張します。これらのサーバーは mcp-config.json ファイルで設定されます。

事前設定済み MCP サーバー

1. Perplexity Search Server

Perplexity AI の API を使用してウェブ検索機能を提供します。

"perplexity-direct": {
  "type": "stdio",
  "name": "PerplexityDirect",
  "command": "uvx",
  "args": ["perplexity-mcp"],
  "env": {
    "PERPLEXITY_API_KEY": "your_perplexity_api_key_here",
    "PERPLEXITY_MODEL": "sonar"
  },
  "cwd": "/path/to/perplexity-mcp",
  "description": "Web search using Perplexity AI"
}

2. Desktop Commander Server

ターミナルとファイルシステム操作を使用したローカルシステムアクセスを提供します。

"desktop-commander": {
  "type": "stdio",
  "name": "DesktopCommander",
  "command": "npx",
  "args": [
    "-y",
    "@wonderwhy-er/desktop-commander"
  ],
  "description": "Provides terminal, filesystem, and editing tools"
}

カスタム MCP サーバーの追加

独自の MCP 互換サーバーを追加してエージェントの機能を拡張できます。

1. サーバープロセスをインストールまたは設定する
2. mcp-config.json の servers オブジェクトに新しいエントリを追加する
3. 開発サーバーを再起動する

使用例

Agentic MCP Client は複数のツールにまたがる複雑なタスクに優れています。

• リサーチアシスタント: ウェブで情報を検索し、ローカルファイルに結果をまとめ、サマリーを生成する
• コードヘルパー: ローカルリポジトリを検索し、コードを分析し、テストを実行し、結果を説明する
• システム管理者: プロセスを監視し、コマンドを実行し、ファイルを自然言語で管理する
• コンテンツクリエイター: トピックをオンラインで調査し、その結果を使用して構造化されたドキュメントを作成する

高度な設定

ツール承認ワークフロー

エージェントは「Auto Approve」用の UI トグルを提供し、以下のように設定できます。

• Manual Mode: 実行前にユーザーのツール呼び出しの承認を求める
• Auto Mode: ユーザー確認なしにツール呼び出しを自動実行する

これにより、人間の監視が必要な操作を細かく制御できます。

新しい機能の追加

エージェントの機能を拡張するには、以下を行います。

1. 必要なツールを提供する追加の MCP サーバーをインストールする
2. mcp-config.json を更新して新しいサーバーを含める
3. カスタムツールの場合は、プロトコル仕様に従って新しい MCP サーバーを実装する

このプロジェクトは次の MCP サーバーでテストされています。

• https://github.com/jsonallen/perplexity-mcp
• https://github.com/wonderwhy-er/DesktopCommanderMCP

貢献

貢献を歓迎します！改善の重要な分野は以下の通りです。

• 追加の MCP サーバー統合
• セキュリティポリシーの強化
• ツールオーケストレーションの改善
• ツール操作の可視化を向上させるための UI 拡張
• 異なる環境全体での包括的なテスト

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。