# 本地模型服务协议（LMSP）

> LMSP 是一套开放协议，用于发现和调用运行在用户自己设备上的语言模型，涵盖服务发现、模型目录、流式响应、持久化的异步任务，以及 OpenAI 兼容接口。

Source: https://madeforagent.com/zh-cn/lmsp/
Language: zh-CN
Updated: 2026-11-08

## LMSP 解决什么问题 {#what}

LMSP（Local Model Service Protocol，本地模型服务协议）是一套开放协议，面向在用户自己设备或局域网中运行语言模型的软件，以及使用这些软件的客户端。

常驻的本地服务会在约定地址上描述自己并列出模型，用 JSON 或服务器发送事件（SSE）回应生成请求，并把长时间的生成作为持久化任务来运行：任务可以取消，客户端断线后也可以重新接上。同一个服务还兼容 OpenAI API，因此今天已有的客户端可以继续使用。

LMSP 并不取代 OpenAI API、Ollama 或 MCP，而是把它们的优点组合成一个适合本地常驻服务的协议层。

## 概览 {#glance}

| 主题 | 概要 |
| --- | --- |
| 默认地址 | `http://127.0.0.1:17832` |
| 服务描述 | `GET /.well-known/lmsp.json` |
| 核心接口 | `/lmsp/v1`，基于 HTTP 的 JSON，流式传输使用服务器发送事件（SSE） |
| 兼容接口 | 面向 OpenAI 客户端的 `/v1`，面向 Ollama 客户端的可选 `/api` |
| 服务发现 | 手动配置、探测本机约定地址、可选的 mDNS 与 DNS-SD（`_lmsp._tcp.local.`） |
| 认证 | 通过本机配对获取的 Bearer Token |
| 持久化 | 嵌入式 SQLite，任务在服务重启后仍然保留 |
| 契约 | OpenAPI 3.2 |

## 快速试用 {#try}

如果你的机器上正运行着 LMSP 服务，完整流程如下。请先按[第 10.2 节](https://madeforagent.com/zh-cn/lmsp/1.0/security.md#pairing)完成配对以获得令牌，并把它保存在 `LMSP_TOKEN` 中。

```sh
# 1. 发现服务
curl http://127.0.0.1:17832/.well-known/lmsp.json

# 2. 列出本地模型
curl http://127.0.0.1:17832/lmsp/v1/models \
  -H "Authorization: Bearer $LMSP_TOKEN"

# 3. 生成响应
curl http://127.0.0.1:17832/lmsp/v1/responses \
  -H "Authorization: Bearer $LMSP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3:14b-q4_k_m","input":[{"type":"message","role":"user","content":[{"type":"input_text","text":"Hello"}]}]}'
```

## 与其他协议的关系 {#related}

| 协议 | 覆盖范围 | 与 LMSP 的关系 |
| --- | --- | --- |
| OpenAI API | 云端托管的模型，Responses API 是其最新接口。 | LMSP 的核心接口沿用 Responses 的结构，服务同时提供兼容 OpenAI 的接口。 |
| Ollama | 本地运行时，已提供兼容 OpenAI 的接口。 | 它可以作为适配器放在 LMSP 服务之后，LMSP 也定义了可选的兼容 Ollama 的接口。 |
| MCP | 把智能体连接到工具和上下文。 | LMSP 把智能体连接到模型。两者都倾向于无状态发现，而不是强制会话。 |
| A2A | 智能体之间的协作。 | LMSP 的服务描述和任务分别借鉴了其服务卡片和显式任务状态。 |

## 资源 {#resources}

- [规范 1.0 版（草案）](https://madeforagent.com/zh-cn/lmsp/1.0.md)。
- OpenAPI 契约，提供 [JSON](https://madeforagent.com/lmsp/1.0/openapi.json) 和 [YAML](https://madeforagent.com/lmsp/1.0/openapi.yaml) 两种格式。
- 面向语言模型的 [llms.txt](https://madeforagent.com/zh-cn/llms.txt) 和 [llms-full.txt](https://madeforagent.com/zh-cn/llms-full.txt)。
- 每个页面都提供 Markdown 版本：把页面地址末尾的斜杠换成 `.md` 即可，例如 [`/zh-cn/lmsp/1.0/tasks.md`](https://madeforagent.com/zh-cn/lmsp/1.0/tasks.md)。

## 常见问题

### LMSP 是什么？

LMSP（Local Model Service Protocol，本地模型服务协议）是一套开放协议，面向运行在用户自己设备或局域网中的语言模型服务，规定客户端如何发现服务、列出模型、请求响应、接收流式输出以及运行长任务。

### LMSP 会取代 OpenAI API、Ollama 或 MCP 吗？

不会。LMSP 建立在它们之上：核心接口沿用 OpenAI Responses 的结构，服务可以同时提供兼容 OpenAI 和兼容 Ollama 的接口，协议还借鉴了 MCP 的无状态发现和 A2A 的任务状态。

### 现有的 OpenAI 客户端可以使用 LMSP 服务吗？

通常可以。只需把 base URL 改为 LMSP 服务的地址，并把 LMSP 令牌作为 API Key。但它们无法自动发现服务，因为服务发现需要支持 LMSP 的客户端。

### 客户端如何发现本地的 LMSP 服务？

按顺序尝试三种方式：先使用用户手动输入的地址，再访问本机约定地址的 /.well-known/lmsp.json，最后在局域网中通过可选的 mDNS 与 DNS-SD 浏览 _lmsp._tcp.local.。

### 只监听 localhost 的模型服务安全吗？

不一定，因为网页可能尝试访问本机端口。LMSP 服务默认绑定回环地址，要求客户端通过本机配对获取 Bearer Token，校验 Origin 与 Host 请求头，局域网模式下必须启用认证。

### 这份规范目前处于什么状态？

1.0 版是首个公开草案，仍可能发生不兼容的修改。英文文本是规范性文本，译文仅为方便阅读而提供。