openapi-docs-mcp 0.1.4 → 0.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +193 -117
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +3 -2
- package/dist/cli.js.map +1 -1
- package/dist/formatter/operation.d.ts.map +1 -1
- package/dist/formatter/operation.js +45 -12
- package/dist/formatter/operation.js.map +1 -1
- package/dist/formatter/schema.d.ts +1 -0
- package/dist/formatter/schema.d.ts.map +1 -1
- package/dist/formatter/schema.js +15 -2
- package/dist/formatter/schema.js.map +1 -1
- package/dist/openapi/diagnostics.d.ts +3 -0
- package/dist/openapi/diagnostics.d.ts.map +1 -0
- package/dist/openapi/diagnostics.js +24 -0
- package/dist/openapi/diagnostics.js.map +1 -0
- package/dist/openapi/loader.d.ts.map +1 -1
- package/dist/openapi/loader.js +61 -45
- package/dist/openapi/loader.js.map +1 -1
- package/dist/openapi/normalize.d.ts +7 -0
- package/dist/openapi/normalize.d.ts.map +1 -0
- package/dist/openapi/normalize.js +203 -0
- package/dist/openapi/normalize.js.map +1 -0
- package/dist/openapi/operations.d.ts.map +1 -1
- package/dist/openapi/operations.js +19 -1
- package/dist/openapi/operations.js.map +1 -1
- package/dist/types.d.ts +11 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +4 -4
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -10,119 +10,125 @@
|
|
|
10
10
|
|
|
11
11
|
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
OpenAPI Docs MCP 是一个厂商无关的 MCP Server。它读取本地或远程的 OpenAPI 文档，在内存中建立索引，让编码 Agent 能快速搜索接口并获取参数、请求体、响应和 Schema。
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
服务只读取接口文档，不会调用文档中描述的真实后端 API。
|
|
16
16
|
|
|
17
|
-
##
|
|
17
|
+
## 功能特性
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
## 详细描述
|
|
19
|
+
- 支持 OpenAPI 3.0、3.1 和 Swagger 2.0；
|
|
20
|
+
- 支持 JSON、YAML、本地文件和 HTTP(S) URL；
|
|
21
|
+
- 支持中英文搜索，并对 Summary、Tag、Path 等字段进行确定性加权；
|
|
22
|
+
- 按需展开本地 `$ref`，限制最大深度和属性数量；
|
|
23
|
+
- 检测循环引用，并标记无法解析的引用；
|
|
24
|
+
- 兼容模式可保守修复能够明确解析的脏 `$ref`；
|
|
25
|
+
- 远程文档支持自定义请求头和超时；
|
|
26
|
+
- 支持运行时重新加载，失败时继续保留旧文档；
|
|
27
|
+
- 通过 stdio 接入任意兼容 MCP 的 Agent 或 IDE。
|
|
30
28
|
|
|
31
|
-
|
|
29
|
+
## 快速开始
|
|
32
30
|
|
|
33
|
-
|
|
31
|
+
要求 Node.js 20 或更高版本。无需安装或克隆项目，直接把以下配置加入 MCP Client：
|
|
34
32
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
33
|
+
```json
|
|
34
|
+
{
|
|
35
|
+
"mcpServers": {
|
|
36
|
+
"project-api-docs": {
|
|
37
|
+
"command": "npx",
|
|
38
|
+
"args": [
|
|
39
|
+
"-y",
|
|
40
|
+
"openapi-docs-mcp",
|
|
41
|
+
"--source",
|
|
42
|
+
"https://api.example.com/v3/api-docs"
|
|
43
|
+
]
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
```
|
|
42
48
|
|
|
43
|
-
|
|
49
|
+
不同客户端的外层字段可能是 `mcpServers`、`servers` 或其他名称，但 `command` 和 `args` 的内容相同。
|
|
44
50
|
|
|
45
|
-
|
|
46
|
-
- 按需展开本地 `$ref`，限制最大深度和属性数量；
|
|
47
|
-
- 检测循环引用，并标记无法解析的引用；
|
|
48
|
-
- 远程文档支持自定义请求头和超时；
|
|
49
|
-
- 刷新失败时保留旧文档，不影响现有查询；
|
|
50
|
-
- 通过 stdio 工作，可接入任意兼容 MCP 的 Agent 或 IDE。
|
|
51
|
+
### 读取本地文档
|
|
51
52
|
|
|
52
|
-
|
|
53
|
+
```bash
|
|
54
|
+
npx -y openapi-docs-mcp --source ./openapi.yaml
|
|
55
|
+
```
|
|
53
56
|
|
|
54
|
-
|
|
55
|
-
| :--- | :--- |
|
|
56
|
-
| 当前版本 | `0.1.4` |
|
|
57
|
-
| 运行环境 | Node.js 20+ |
|
|
58
|
-
| 项目阶段 | 可用的早期版本 |
|
|
59
|
-
| 传输方式 | stdio |
|
|
60
|
-
| 许可证 | MIT |
|
|
57
|
+
MCP Client 中使用本地文件时，建议将文档路径写成绝对路径。
|
|
61
58
|
|
|
62
|
-
|
|
59
|
+
### 读取需要鉴权的远程文档
|
|
63
60
|
|
|
64
|
-
|
|
61
|
+
```bash
|
|
62
|
+
npx -y openapi-docs-mcp \
|
|
63
|
+
--source https://api.example.com/v3/api-docs \
|
|
64
|
+
--header Authorization="Bearer token" \
|
|
65
|
+
--header X-Tenant-Id=tenant-1 \
|
|
66
|
+
--timeout 30000
|
|
67
|
+
```
|
|
65
68
|
|
|
66
|
-
###
|
|
69
|
+
### 同时连接多个项目
|
|
67
70
|
|
|
68
|
-
|
|
71
|
+
每份 OpenAPI 文档对应一个独立实例：
|
|
69
72
|
|
|
70
73
|
```json
|
|
71
74
|
{
|
|
72
75
|
"mcpServers": {
|
|
73
|
-
"
|
|
76
|
+
"order-api-docs": {
|
|
77
|
+
"command": "npx",
|
|
78
|
+
"args": [
|
|
79
|
+
"-y",
|
|
80
|
+
"openapi-docs-mcp",
|
|
81
|
+
"--source",
|
|
82
|
+
"https://order.example.com/v3/api-docs"
|
|
83
|
+
]
|
|
84
|
+
},
|
|
85
|
+
"user-api-docs": {
|
|
74
86
|
"command": "npx",
|
|
75
87
|
"args": [
|
|
76
88
|
"-y",
|
|
77
|
-
"openapi-docs-mcp
|
|
89
|
+
"openapi-docs-mcp",
|
|
78
90
|
"--source",
|
|
79
|
-
"https://
|
|
80
|
-
"--timeout",
|
|
81
|
-
"30000"
|
|
91
|
+
"https://user.example.com/v3/api-docs"
|
|
82
92
|
]
|
|
83
93
|
}
|
|
84
94
|
}
|
|
85
95
|
}
|
|
86
96
|
```
|
|
87
97
|
|
|
88
|
-
|
|
98
|
+
各实例独立加载和刷新自己的文档，互不影响。
|
|
99
|
+
|
|
100
|
+
## 其他安装方式
|
|
89
101
|
|
|
90
|
-
|
|
102
|
+
### 全局安装
|
|
91
103
|
|
|
92
104
|
```bash
|
|
93
|
-
npm install --global openapi-docs-mcp
|
|
94
|
-
openapi-docs-mcp --source https://api.example.com/v3/api-docs
|
|
105
|
+
npm install --global openapi-docs-mcp
|
|
106
|
+
openapi-docs-mcp --source https://api.example.com/v3/api-docs
|
|
95
107
|
```
|
|
96
108
|
|
|
97
|
-
|
|
109
|
+
全局安装后的 MCP 配置：
|
|
98
110
|
|
|
99
111
|
```json
|
|
100
112
|
{
|
|
101
113
|
"mcpServers": {
|
|
102
114
|
"project-api-docs": {
|
|
103
115
|
"command": "openapi-docs-mcp",
|
|
104
|
-
"args": [
|
|
105
|
-
"--source",
|
|
106
|
-
"https://api.example.com/v3/api-docs",
|
|
107
|
-
"--timeout",
|
|
108
|
-
"30000"
|
|
109
|
-
]
|
|
116
|
+
"args": ["--source", "https://api.example.com/v3/api-docs"]
|
|
110
117
|
}
|
|
111
118
|
}
|
|
112
119
|
}
|
|
113
120
|
```
|
|
114
121
|
|
|
115
|
-
###
|
|
122
|
+
### 使用 mise 固定 Node.js 版本
|
|
116
123
|
|
|
117
|
-
如果 MCP Client
|
|
124
|
+
如果 MCP Client 使用的 Node.js 或 `npx` 不兼容，可以通过 mise 固定运行时：
|
|
118
125
|
|
|
119
126
|
```bash
|
|
120
|
-
mise exec node@24 -- npx --yes openapi-docs-mcp
|
|
121
|
-
--source https://api.example.com/v3/api-docs
|
|
122
|
-
--timeout 30000
|
|
127
|
+
mise exec node@24 -- npx --yes openapi-docs-mcp \
|
|
128
|
+
--source https://api.example.com/v3/api-docs
|
|
123
129
|
```
|
|
124
130
|
|
|
125
|
-
|
|
131
|
+
对应的 MCP 配置：
|
|
126
132
|
|
|
127
133
|
```json
|
|
128
134
|
{
|
|
@@ -135,83 +141,153 @@ mise exec node@24 -- npx --yes openapi-docs-mcp@0.1.4 \
|
|
|
135
141
|
"--",
|
|
136
142
|
"npx",
|
|
137
143
|
"--yes",
|
|
138
|
-
"openapi-docs-mcp
|
|
144
|
+
"openapi-docs-mcp",
|
|
139
145
|
"--source",
|
|
140
|
-
"https://api.example.com/v3/api-docs"
|
|
141
|
-
"--timeout",
|
|
142
|
-
"30000"
|
|
146
|
+
"https://api.example.com/v3/api-docs"
|
|
143
147
|
]
|
|
144
148
|
}
|
|
145
149
|
}
|
|
146
150
|
}
|
|
147
151
|
```
|
|
148
152
|
|
|
149
|
-
|
|
153
|
+
如果客户端找不到 `mise`，可使用 Windows 的 `where.exe mise` 或 macOS/Linux 的 `which mise` 查询路径，并将 `command` 替换为绝对路径。
|
|
150
154
|
|
|
151
|
-
|
|
155
|
+
## CLI 参数
|
|
152
156
|
|
|
153
|
-
|
|
157
|
+
| 参数 | 说明 |
|
|
158
|
+
| :--------------------- | :---------------------------------------------- |
|
|
159
|
+
| `-s, --source <value>` | OpenAPI JSON/YAML 文件或 HTTP(S) URL，必填 |
|
|
160
|
+
| `--header NAME=VALUE` | 加载远程文档时使用的请求头，可重复传入 |
|
|
161
|
+
| `--timeout <ms>` | 远程加载超时，默认 10000 毫秒 |
|
|
162
|
+
| `--strict-validation` | 禁用兼容修复，并将所有 OpenAPI 校验警告视为错误 |
|
|
163
|
+
| `-h, --help` | 显示帮助 |
|
|
154
164
|
|
|
155
|
-
|
|
156
|
-
{
|
|
157
|
-
"mcpServers": {
|
|
158
|
-
"order-api-docs": {
|
|
159
|
-
"command": "npx",
|
|
160
|
-
"args": [
|
|
161
|
-
"-y",
|
|
162
|
-
"openapi-docs-mcp@0.1.4",
|
|
163
|
-
"--source",
|
|
164
|
-
"https://order.example.com/v3/api-docs"
|
|
165
|
-
]
|
|
166
|
-
},
|
|
167
|
-
"user-api-docs": {
|
|
168
|
-
"command": "npx",
|
|
169
|
-
"args": [
|
|
170
|
-
"-y",
|
|
171
|
-
"openapi-docs-mcp@0.1.4",
|
|
172
|
-
"--source",
|
|
173
|
-
"https://user.example.com/v3/api-docs"
|
|
174
|
-
]
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
}
|
|
178
|
-
```
|
|
165
|
+
## MCP 工具
|
|
179
166
|
|
|
180
|
-
|
|
167
|
+
| 工具 | 作用 |
|
|
168
|
+
| :---------------- | :------------------------------------------------- |
|
|
169
|
+
| `search_api` | 按关键词、路径、Tag、描述或 `operationId` 搜索接口 |
|
|
170
|
+
| `get_api` | 获取接口参数、请求体、响应和展开后的 Schema |
|
|
171
|
+
| `get_schema` | 按名称读取组件 Schema |
|
|
172
|
+
| `list_groups` | 列出 OpenAPI Tags 及接口数量 |
|
|
173
|
+
| `reload_document` | 重新加载文档，无需重启 MCP Server |
|
|
181
174
|
|
|
182
|
-
###
|
|
175
|
+
### `search_api`
|
|
183
176
|
|
|
184
|
-
|
|
177
|
+
返回经过排序的轻量候选结果。推荐先搜索，再把结果中的 `id` 传给 `get_api`。
|
|
185
178
|
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
179
|
+
| 参数 | 必填 | 说明 |
|
|
180
|
+
| :------- | :--: | :----------------------------------------------- |
|
|
181
|
+
| `query` | 否 | 搜索关键词，例如 `异常分页列表` 或 `create user` |
|
|
182
|
+
| `method` | 否 | HTTP 方法过滤条件，例如 `GET`、`POST` |
|
|
183
|
+
| `tag` | 否 | 精确匹配 OpenAPI Tag |
|
|
184
|
+
| `limit` | 否 | 返回数量，默认 10，最大 50 |
|
|
189
185
|
|
|
190
|
-
|
|
186
|
+
搜索依次侧重 `summary`、`tags`、`path`、`description` 和 `operationId`。中文搜索不依赖空格分词，会结合标准化、包含匹配和字符片段进行评分。
|
|
191
187
|
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
188
|
+
### `get_api`
|
|
189
|
+
|
|
190
|
+
获取单个接口的完整上下文，包括 HTTP 方法、路径、参数、请求体、响应、Tags、Security、Deprecated 元数据和展开后的 Schema。
|
|
191
|
+
|
|
192
|
+
优先传入 `search_api` 返回的 `id`；也可以传入精确的 `path` 和可选的 `method`。`maxDepth` 控制 Schema 最大展开深度，默认 5，范围为 1–12。
|
|
193
|
+
|
|
194
|
+
### `get_schema`
|
|
195
|
+
|
|
196
|
+
按精确名称读取 `components.schemas` 中的 Schema。`maxDepth` 同样默认为 5，范围为 1–12。本地 `$ref` 展开具有深度、属性数量和循环引用保护。
|
|
197
|
+
|
|
198
|
+
### `list_groups`
|
|
199
|
+
|
|
200
|
+
列出 OpenAPI Tags 及每个 Tag 下的接口数量。没有 Tag 的接口归入 `untagged`。
|
|
201
|
+
|
|
202
|
+
### `reload_document`
|
|
203
|
+
|
|
204
|
+
重新加载并校验启动时指定的文档，然后原子替换内存索引。加载失败时返回错误，并继续使用上一次成功加载的文档。
|
|
205
|
+
|
|
206
|
+
## 推荐调用流程
|
|
207
|
+
|
|
208
|
+
```text
|
|
209
|
+
用户描述需要实现的功能
|
|
210
|
+
↓
|
|
211
|
+
search_api 搜索候选接口
|
|
212
|
+
↓
|
|
213
|
+
根据 summary、tag、path 选择接口
|
|
214
|
+
↓
|
|
215
|
+
get_api 获取请求和响应结构
|
|
216
|
+
↓
|
|
217
|
+
必要时调用 get_schema
|
|
218
|
+
↓
|
|
219
|
+
生成类型、API 方法或业务代码
|
|
198
220
|
```
|
|
199
221
|
|
|
200
|
-
|
|
222
|
+
## 文档兼容与校验
|
|
223
|
+
|
|
224
|
+
默认使用兼容校验模式。部分 Springdoc 文档会生成包含中文名称、缺少本地前缀或未转义 JSON Pointer 字符的 `$ref`。只要目标能够唯一确定，项目就会修复内存副本并输出诊断，但不会修改源文件。
|
|
225
|
+
|
|
226
|
+
兼容模式还会跳过无法表示为对象的 path item 或 operation，并为缺少 `responses` 的 operation 补充空对象。修复、跳过、未解析引用和歧义引用会通过 stderr 输出有界摘要，不会污染 MCP 使用的 stdout。
|
|
227
|
+
|
|
228
|
+
无法解析或存在多个精确候选的引用会保留原值。项目不会进行模糊、忽略大小写或裁剪空白后的匹配，也不会加载外部 URL 或文件引用。无法解析文档，或缺少顶层版本、`info`、`paths` 等整体不可用的情况，仍会阻止服务启动。
|
|
201
229
|
|
|
202
|
-
|
|
203
|
-
| :--- | :--- |
|
|
204
|
-
| `-s, --source <value>` | OpenAPI 文件或 HTTP(S) URL，必填 |
|
|
205
|
-
| `--header NAME=VALUE` | 远程文档请求头，可重复使用 |
|
|
206
|
-
| `--timeout <ms>` | 远程加载超时，默认 10000 毫秒 |
|
|
207
|
-
| `--strict-validation` | 将所有 OpenAPI 校验警告视为错误 |
|
|
208
|
-
| `-h, --help` | 显示帮助 |
|
|
230
|
+
如需禁用所有兼容修复，请使用 `--strict-validation`。
|
|
209
231
|
|
|
210
|
-
|
|
232
|
+
## 当前限制
|
|
233
|
+
|
|
234
|
+
- 不调用真实后端 API；
|
|
235
|
+
- 不保存或管理后端鉴权凭证；
|
|
236
|
+
- 不展开其他文件或 URL 中的外部 `$ref`；
|
|
237
|
+
- 不提供向量数据库或 Embedding 搜索；
|
|
238
|
+
- 不支持 Streamable HTTP 部署；
|
|
239
|
+
- 不自动轮询 OpenAPI 文档或监听文件变化；
|
|
240
|
+
- 不依赖模型厂商私有能力。
|
|
241
|
+
|
|
242
|
+
文档发生变化时，可调用 `reload_document`，也可以重启 MCP Server。
|
|
243
|
+
|
|
244
|
+
## 本地开发
|
|
211
245
|
|
|
212
246
|
```bash
|
|
213
247
|
pnpm install
|
|
248
|
+
pnpm typecheck
|
|
214
249
|
pnpm test
|
|
215
250
|
pnpm build
|
|
216
251
|
node dist/cli.js --source ./openapi.json
|
|
217
252
|
```
|
|
253
|
+
|
|
254
|
+
本地 MCP 配置需要使用 `dist/cli.js` 和 OpenAPI 文档的绝对路径：
|
|
255
|
+
|
|
256
|
+
```json
|
|
257
|
+
{
|
|
258
|
+
"mcpServers": {
|
|
259
|
+
"local-api-docs": {
|
|
260
|
+
"command": "node",
|
|
261
|
+
"args": [
|
|
262
|
+
"C:/absolute/path/openapi-docs-mcp/dist/cli.js",
|
|
263
|
+
"--source",
|
|
264
|
+
"C:/absolute/path/openapi.json"
|
|
265
|
+
]
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
## 设计原则
|
|
272
|
+
|
|
273
|
+
```text
|
|
274
|
+
OpenAPI / Swagger
|
|
275
|
+
↓
|
|
276
|
+
解析、保守归一化与校验
|
|
277
|
+
↓
|
|
278
|
+
标准 OpenAPI Document
|
|
279
|
+
↓
|
|
280
|
+
内存 Operation 索引
|
|
281
|
+
↓
|
|
282
|
+
Search + Formatter
|
|
283
|
+
↓
|
|
284
|
+
标准 MCP Tools
|
|
285
|
+
↓
|
|
286
|
+
任意支持 MCP 的 Agent 或 IDE
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
OpenAPI Document 始终是事实来源，自定义类型只用于搜索结果和 MCP 输出。Formatter 不会改写已加载的 OpenAPI 声明；兼容模式只在加载阶段修复能够唯一确定目标的局部缺陷，避免根据相似度猜测后端含义。
|
|
290
|
+
|
|
291
|
+
## License
|
|
292
|
+
|
|
293
|
+
[MIT](LICENSE)
|
package/dist/cli.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAOA,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAwBD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA2CpD"}
|
package/dist/cli.js
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { serveStdio } from "@modelcontextprotocol/server/stdio";
|
|
3
3
|
import { loadOpenApi } from "./openapi/loader.js";
|
|
4
|
+
import { formatDiagnosticSummary } from "./openapi/diagnostics.js";
|
|
4
5
|
import { createMcpServer } from "./mcp/server.js";
|
|
5
6
|
import { OpenApiService } from "./service.js";
|
|
6
7
|
async function main() {
|
|
@@ -14,8 +15,8 @@ async function main() {
|
|
|
14
15
|
const context = await reload();
|
|
15
16
|
const service = new OpenApiService(context, reload);
|
|
16
17
|
console.error(`Loaded ${context.operations.length} operations from ${context.source} (OpenAPI ${context.version})`);
|
|
17
|
-
for (const
|
|
18
|
-
console.error(
|
|
18
|
+
for (const line of formatDiagnosticSummary(context.diagnostics)) {
|
|
19
|
+
console.error(line);
|
|
19
20
|
}
|
|
20
21
|
serveStdio(() => createMcpServer(service), {
|
|
21
22
|
onerror: (error) => console.error(error),
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAS9C,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG;QAClB,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,cAAc,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY;KAC1D,CAAC;IACX,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,MAAM,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEpD,OAAO,CAAC,KAAK,CACX,UAAU,OAAO,CAAC,UAAU,CAAC,MAAM,oBAAoB,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,OAAO,GAAG,CACrG,CAAC;IACF,KAAK,MAAM,
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/formatter/operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/formatter/operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAanF,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAC1B,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,mBAAwB,GAChC,UAAU,CAuCZ"}
|
|
@@ -1,18 +1,18 @@
|
|
|
1
1
|
import { asObject, asString } from "../openapi/operations.js";
|
|
2
|
-
import { formatSchema, resolveLocalReference } from "./schema.js";
|
|
2
|
+
import { decodeReferenceName, formatSchema, resolveLocalReference, } from "./schema.js";
|
|
3
3
|
export function formatOperation(document, entry, options = {}) {
|
|
4
4
|
const operation = entry.operation;
|
|
5
5
|
const parameters = [
|
|
6
6
|
...asArray(entry.pathItem.parameters),
|
|
7
7
|
...asArray(operation.parameters),
|
|
8
|
-
].map((parameter) => formatParameter(document, parameter, options));
|
|
8
|
+
].map((parameter) => formatParameter(document, parameter, options, initialReferenceState()));
|
|
9
9
|
const result = {
|
|
10
10
|
id: entry.id,
|
|
11
11
|
method: entry.method.toUpperCase(),
|
|
12
12
|
path: entry.path,
|
|
13
13
|
tags: entry.tags,
|
|
14
14
|
parameters,
|
|
15
|
-
responses: formatResponses(document, operation.responses, options),
|
|
15
|
+
responses: formatResponses(document, operation.responses, options, initialReferenceState()),
|
|
16
16
|
};
|
|
17
17
|
copyIfDefined(result, "summary", entry.summary);
|
|
18
18
|
copyIfDefined(result, "description", entry.description);
|
|
@@ -20,20 +20,24 @@ export function formatOperation(document, entry, options = {}) {
|
|
|
20
20
|
copyIfDefined(result, "deprecated", operation.deprecated);
|
|
21
21
|
copyIfDefined(result, "security", operation.security);
|
|
22
22
|
const requestBody = asObject(operation.requestBody);
|
|
23
|
-
if (requestBody)
|
|
24
|
-
result.requestBody = formatRequestBody(document, requestBody, options);
|
|
23
|
+
if (requestBody) {
|
|
24
|
+
result.requestBody = formatRequestBody(document, requestBody, options, initialReferenceState());
|
|
25
|
+
}
|
|
25
26
|
return result;
|
|
26
27
|
}
|
|
27
|
-
function formatParameter(document, rawParameter, options) {
|
|
28
|
+
function formatParameter(document, rawParameter, options, state) {
|
|
28
29
|
const parameter = asObject(rawParameter);
|
|
29
30
|
if (!parameter)
|
|
30
31
|
return rawParameter;
|
|
31
32
|
const ref = asString(parameter.$ref);
|
|
32
33
|
if (ref) {
|
|
34
|
+
const boundary = referenceBoundary(ref, options, state);
|
|
35
|
+
if (boundary)
|
|
36
|
+
return boundary;
|
|
33
37
|
const resolved = resolveLocalReference(document, ref);
|
|
34
38
|
return referenceEnvelope(ref, resolved === undefined
|
|
35
39
|
? undefined
|
|
36
|
-
: formatParameter(document, withoutSameReference(resolved, ref), options), "parameter");
|
|
40
|
+
: formatParameter(document, withoutSameReference(resolved, ref), options, nextReferenceState(state, ref)), "parameter");
|
|
37
41
|
}
|
|
38
42
|
const result = {};
|
|
39
43
|
for (const key of ["name", "in", "required", "description", "deprecated", "style", "explode"]) {
|
|
@@ -47,12 +51,17 @@ function formatParameter(document, rawParameter, options) {
|
|
|
47
51
|
}
|
|
48
52
|
return result;
|
|
49
53
|
}
|
|
50
|
-
function formatRequestBody(document, requestBody, options) {
|
|
54
|
+
function formatRequestBody(document, requestBody, options, state) {
|
|
51
55
|
const ref = asString(requestBody.$ref);
|
|
52
56
|
if (ref) {
|
|
57
|
+
const boundary = referenceBoundary(ref, options, state);
|
|
58
|
+
if (boundary)
|
|
59
|
+
return boundary;
|
|
53
60
|
const resolved = resolveLocalReference(document, ref);
|
|
54
61
|
const body = asObject(withoutSameReference(resolved, ref));
|
|
55
|
-
return referenceEnvelope(ref, body
|
|
62
|
+
return referenceEnvelope(ref, body
|
|
63
|
+
? formatRequestBody(document, body, options, nextReferenceState(state, ref))
|
|
64
|
+
: undefined, "requestBody");
|
|
56
65
|
}
|
|
57
66
|
const result = {
|
|
58
67
|
required: requestBody.required === true,
|
|
@@ -61,7 +70,7 @@ function formatRequestBody(document, requestBody, options) {
|
|
|
61
70
|
copyIfDefined(result, "description", requestBody.description);
|
|
62
71
|
return result;
|
|
63
72
|
}
|
|
64
|
-
function formatResponses(document, rawResponses, options) {
|
|
73
|
+
function formatResponses(document, rawResponses, options, state) {
|
|
65
74
|
const responses = asObject(rawResponses);
|
|
66
75
|
if (!responses)
|
|
67
76
|
return {};
|
|
@@ -71,11 +80,14 @@ function formatResponses(document, rawResponses, options) {
|
|
|
71
80
|
return [status, rawResponse];
|
|
72
81
|
const ref = asString(response.$ref);
|
|
73
82
|
if (ref) {
|
|
83
|
+
const boundary = referenceBoundary(ref, options, state);
|
|
84
|
+
if (boundary)
|
|
85
|
+
return [status, boundary];
|
|
74
86
|
const resolved = asObject(withoutSameReference(resolveLocalReference(document, ref), ref));
|
|
75
87
|
return [
|
|
76
88
|
status,
|
|
77
89
|
referenceEnvelope(ref, resolved
|
|
78
|
-
? formatResponses(document, { resolved }, options).resolved
|
|
90
|
+
? formatResponses(document, { resolved }, options, nextReferenceState(state, ref)).resolved
|
|
79
91
|
: undefined, "response"),
|
|
80
92
|
];
|
|
81
93
|
}
|
|
@@ -120,7 +132,7 @@ function copyIfDefined(target, key, value) {
|
|
|
120
132
|
function referenceEnvelope(ref, value, key) {
|
|
121
133
|
const result = {
|
|
122
134
|
$ref: ref,
|
|
123
|
-
name:
|
|
135
|
+
name: decodeReferenceName(ref),
|
|
124
136
|
};
|
|
125
137
|
if (value === undefined)
|
|
126
138
|
result.unresolved = true;
|
|
@@ -128,6 +140,27 @@ function referenceEnvelope(ref, value, key) {
|
|
|
128
140
|
result[key] = value;
|
|
129
141
|
return result;
|
|
130
142
|
}
|
|
143
|
+
function referenceBoundary(ref, options, state) {
|
|
144
|
+
if (state.references.has(ref)) {
|
|
145
|
+
return { $ref: ref, name: decodeReferenceName(ref), circular: true };
|
|
146
|
+
}
|
|
147
|
+
if (state.depth >= (options.maxDepth ?? 5)) {
|
|
148
|
+
return {
|
|
149
|
+
$ref: ref,
|
|
150
|
+
name: decodeReferenceName(ref),
|
|
151
|
+
truncated: "maxDepth",
|
|
152
|
+
};
|
|
153
|
+
}
|
|
154
|
+
return undefined;
|
|
155
|
+
}
|
|
156
|
+
function initialReferenceState() {
|
|
157
|
+
return { depth: 0, references: new Set() };
|
|
158
|
+
}
|
|
159
|
+
function nextReferenceState(state, ref) {
|
|
160
|
+
const references = new Set(state.references);
|
|
161
|
+
references.add(ref);
|
|
162
|
+
return { depth: state.depth + 1, references };
|
|
163
|
+
}
|
|
131
164
|
function withoutSameReference(value, ref) {
|
|
132
165
|
const object = asObject(value);
|
|
133
166
|
return object?.$ref === ref ? undefined : value;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"operation.js","sourceRoot":"","sources":["../../src/formatter/operation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,
|
|
1
|
+
{"version":3,"file":"operation.js","sourceRoot":"","sources":["../../src/formatter/operation.ts"],"names":[],"mappings":"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"}
|