关键词

Mistral AIClaude Desktop语言模型对话MCP适配器

使用说明

项目简介

Mistral MCP 适配器是一个允许您在任何兼容 Model Context Protocol (MCP) 的应用（如 Claude Desktop）中使用 Mistral AI 模型的工具。它充当桥梁，将 MCP 协议请求转换为 Mistral API 调用，从而使您可以在 MCP 环境中利用 Mistral 强大的语言模型。

主要功能点

  • MCP 协议适配: 实现了 Model Context Protocol 服务器，可以接收和响应 MCP 客户端的请求。
  • Mistral API 集成: 对接 Mistral AI API，支持多种 Mistral 模型。
  • 对话管理: 维护对话历史记录，为连续对话提供上下文支持。
  • 参数控制: 允许用户配置温度 (temperature) 等模型参数。
  • 工具注册: 提供 "chat" 工具，用于与 Mistral 模型进行对话。
  • 易于集成 Claude Desktop: 提供详细的 Claude Desktop 配置指南。
  • 测试客户端: 包含一个简单的命令行测试客户端，方便用户直接测试适配器功能。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/itisaevalex/mistral-mcp-adapter.git
cd mistral-mcp-adapter

  2. 安装依赖: 确保您已安装 Node.js (v14 或更高版本) 和 npm 或 yarn。

    npm install

  3. 配置环境变量: 在项目根目录下创建 '.env' 文件，并添加您的 Mistral API 密钥和模型名称：

    MISTRAL_API_KEY=your_mistral_api_key_here
MISTRAL_MODEL=mistral-medium

    请替换 'your_mistral_api_key_here' 为您真实的 Mistral API 密钥，并根据需要选择 'MISTRAL_MODEL' (默认为 'mistral-medium')。

  4. 构建项目:

    npm run build

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端中配置服务器连接信息。以下是 Claude Desktop 的配置示例，您需要将以下 JSON 配置添加到 Claude Desktop 的配置文件 '~/.claude-desktop/config.json' 中 'mcpServers' 字段下：

{
  "mcpServers": {
    "mistral-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/mistral-mcp-adapter/dist/index.js"]
    }
  }
}

配置参数说明:

  • 'server name': 'mistral-mcp' (服务器名称，在 Claude Desktop 中使用 '@服务器名称.工具名称' 的形式调用)
  • 'command': 'node' (启动服务器的命令，这里使用 Node.js 解释器)
  • 'args': '["/absolute/path/to/mistral-mcp-adapter/dist/index.js"]' (传递给 'node' 命令的参数，指向适配器编译后的入口文件。请将 '/absolute/path/to/mistral-mcp-adapter' 替换为您的 'mistral-mcp-adapter' 仓库在您系统中的绝对路径)

配置完成后，重启 Claude Desktop 以加载新的服务器配置。

基本使用方法

1. 启动 MCP 服务器: 在项目根目录下，运行以下命令启动 Mistral MCP 适配器服务器：

npm start

服务器成功启动后，您将在终端看到 '✅ Mistral MCP Adapter running on stdio' 的提示信息。

2. 在 MCP 客户端中使用:

  • Claude Desktop: 在 Claude Desktop 中，您可以使用 '@mistral-mcp.chat' 命令与 Mistral 模型进行对话。例如：

    @mistral-mcp.chat 你好，世界！

    您还可以使用 'conversation_id' 参数来管理对话上下文：

    @mistral-mcp.chat 记住上面的问题。 conversation_id=my-conversation
@mistral-mcp.chat 刚刚我问了什么问题？ conversation_id=my-conversation

  • 测试客户端: 仓库包含一个简单的测试客户端 'test-client.ts'。您可以使用以下命令运行测试客户端，直接与 MCP 服务器进行交互：

    npx ts-node test-client.ts

    运行后，您可以在命令行中输入消息并与 Mistral 模型对话。

添加更多工具 (开发者参考)

如果您希望扩展 MCP 服务器的功能，例如添加新的工具，您可以参考 'src/mcp-adapter.ts' 文件，修改 'ListToolsRequestSchema' 和 'CallToolRequestSchema' 的处理逻辑。

信息

分类

AI与计算

访问项目