Universal Mistral MCP Adapter

Mistr. Agent

一个用于 Mistral AI 模型的自主 MCP 客户端，集成了模型上下文协议 (MCP)，可在本地和网络环境中实现 AI 驱动的任务执行。

概述

Agentic MCP 客户端提供了一个现代化界面，通过模型上下文协议 (MCP) 将 Mistral 大模型与现实世界的功能相连接。它使大模型能够通过跨不同环境的多个工具进行编排来自主执行任务——从网络搜索到本地文件操作和系统命令执行。

与基础聊天界面不同，该 Agent 能够在多步骤操作中保持上下文，在遇到错误时进行自我纠正，并提供用于控制工具访问的安全机制——创造真正具有实际应用价值的 Agent AI 体验。

屏幕截图

工具调用集成	深色模式界面

聊天历史界面	工具列表下拉菜单

核心功能

🧠 自主任务执行

• 多轮次、多工具任务完成，保持上下文连贯性
• 参数不正确时的工具使用自我纠正
• 复杂的错误处理与详细反馈
• 跨对话轮次的工具状态管理

🛠️ 工具集成框架

• MCP 服务及其能力的动态加载
• 自动工具发现和能力协商
• 跨多个服务的智能工具路由
• 带有参数验证的增强工具描述

🔒 安全与控制

• 对敏感操作的人工审核批准
• 工具访问的速率限制
• 潜在危险操作检测
• 所有工具使用的详细审计日志

💻 系统集成

• 终端命令执行和进程管理
• 本地文件系统操作（读取、写入、列表、搜索、编辑）
• 文件内容分析与操作
• 跨平台兼容性

🌐 外部服务

• 通过 Perplexity AI 集成进行网络搜索
• 可通过 MCP 扩展到其他 API 服务
• 天气信息检索
• 能够添加自定义服务集成

系统要求

• 网络连接：访问 Mistral 模型 API 和 Perplexity 搜索所需
• Node.js：v16.x 或更高版本
• 内存：最低 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 服务配置

Agent 连接到 Model Context Protocol (MCP) 服务以扩展其功能。这些服务在 mcp-config.json 文件中进行配置：

预配置的 MCP 服务

1. Perplexity 搜索服务

使用 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": {
  "type": "stdio",
  "name": "DesktopCommander",
  "command": "npx",
  "args": [
    "-y",
    "@wonderwhy-er/desktop-commander"
  ],
  "description": "Provides terminal, filesystem, and editing tools"
}

添加自定义 MCP 服务

您可以通过添加自己的 MCP 兼容服务来扩展 Agent 的功能：

1. 安装或设置服务进程
2. 在 mcp-config.json 的 servers 对象中添加新条目
3. 重启开发服务器

示例用例

Agent 式 MCP 客户端在跨多个工具的复杂任务中表现出色：

• 研究助手：在网络上搜索信息，将发现编译到本地文件，并生成总结
• 代码助手：搜索本地存储库、分析代码、执行测试并解释结果
• 系统管理员：使用自然语言监控进程、执行命令和管理文件
• 内容创作者：在线研究主题，并使用发现创建结构化文档

高级配置

工具审批工作流

Agent 提供"自动批准"UI 切换，可以配置为：

• 手动模式：在执行前向用户呈现工具调用以获得批准
• 自动模式：无需用户确认自动执行工具调用

这允许对哪些操作需要人工监督进行细粒度控制。

添加新功能

要扩展 Agent 的功能：

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 文件。