内容
<div align="center">
# Mistral AI
### Mistral AI 的 API（La Plateforme）：一个与 OpenAI 兼容的聊天和推理端点（Mistral Large/Medium/Small, Magistral），视觉（Pixtral），代码补全和中间填充（Codestral/Devstral），文本嵌入，文档 OCR 和内容审核 — 以及文件，批量处理，微调和代理。
</div>
---
> **作者：** [Simon-Pierre Boucher](https://github.com/simonpierreboucher02) · spbou4@icloud.com
> **AgentiLab** 提供商知识库的一部分。
**分类：** AI 模型提供商 · 嵌入 · 开发者工具
**标签：** `llm` `mistral` `codestral` `pixtral` `chat` `embeddings` `ocr` `vision` `openai-compatible` `agents`
该存储库包含了 AI 代理（或开发者）使用 **Mistral AI** API 所需的一切：易读的 **文档**，一个可运行的 **MCP 服务器**，以及一个打包的 **代理技能**。
## 📊 概览
| 资产 | 内容 |
|-------|----------|
| 📚 **API 文档** | 53 个 Markdown 页面 |
| 🔌 **MCP 服务器** | 7 个工具 · 31 个 TypeScript 文件 |
| 🧠 **代理技能** | 4 个配方 · 2 个提示 |
| 🗂️ **总文件数** | 119 |
| 🔑 **环境变量** | `MISTRAL_API_KEY` |
| 🛡️ **身份验证** | Bearer token（授权头部）。从 https://console.mistral.ai 获取密钥。 |
| 💳 **定价** | 基于使用情况，按模型计费（每 100 万个输入/输出）；嵌入和 OCR 按 token/页面计费。提供具有每日配额的免费层；Batch API 约便宜 50%。 |
## 📦 内容
### 📚 `api-docs/` — 文档
结构化、示例丰富的文档，涵盖概述、快速入门、完整的 API 参考、代码示例、代理集成、生产模式和配方。
从 [`api-docs/README.md`](api-docs/README.md) 开始。
### 🔌 `mcp/` — 模型上下文协议服务器
一个类型化的 MCP 服务器，将 Mistral AI 暴露为代理工具：
`mistral_chat` · `mistral_models` · `mistral_embeddings` · `mistral_fim` · `mistral_ocr` · `mistral_moderations` · `mistral_request`
安装、配置和工具参考位于
[`mcp/README.md`](mcp/README.md) 和 [`mcp/docs/`](mcp/docs)。
直接客户端配置：[`mcp/examples/claude-desktop-config.json`](mcp/examples/claude-desktop-config.json)。
### 🧠 `skill/` — 代理技能
一个便携的技能（配方、提示、参考和评估测试），教导代理如何有效地使用 Mistral AI。参见 [`skill/SKILL.md`](skill/SKILL.md)。
## 🚀 快速开始（MCP 服务器）
```bash
cd mcp/server
npm install
cp .env.example .env # 设置 MISTRAL_API_KEY
npm run build && npm start
```
然后使用示例配置将任何 MCP 客户端（例如 Claude Desktop）指向服务器。
## 🔗 链接
- 🌐 官网：https://mistral.ai
- 📖 官方文档：https://docs.mistral.ai
- 🧪 AgentiLab：https://www.agentilab.ai
## 👤 作者
**Simon-Pierre Boucher**
GitHub：[@simonpierreboucher02](https://github.com/simonpierreboucher02) · 邮箱：spbou4@icloud.com
