@ haddowg/ json- api- mcp
部分 jsonapi.rest (英语) 套间 - 完整、符合规格 JSON: API 1. 1 堆栈: 框架不可知 PHP 核心项目页:1 符号捆绑页:1 Laravel 软件包,则 键入类型脚本 客户端,由经过检测的OpenAPI 3.1合同捆绑在一起. 完整文档: (原始内容存档于2018-10-21) (韩语). haddog.github.io/json-api-ts。 。 。 .
MCP 工具定义和调用处理器 haddowg/json-api 服务器。 建设时间
生成器将服务器的 OpenAPI 文档转换成一个 JSON 模型, 由您执行
运行时间为每次收集、资源、相关和自定义操作服务一个工具,
在 OpenAI 和 Anthropic 的严格模式下, 输入方案是有效的。 呼叫通过
@haddowg/json-api-client。软件包没有MCP服务器:主机列表
工具,并传递电话给处理者.
安装
npm install @haddowg/json-api-mcp @haddowg/json-api-client
npm install --save-dev @haddowg/json-api-codegen
生成模型
npx @haddowg/json-api-mcp --input openapi/v5.json --output src/mcp/v5.mcp.json
npx @haddowg/json-api-mcp --input openapi/v5.json --output src/mcp/v5.mcp.json --check # in CI
这个模型产生,它的领先者 $comment 这么说的 重生而不是编辑
是手写的.
工具默认包含一个深层关系,所以每个工具的图案只包含其类型
直接关系到达。 过 --include-depth <n>,或 all 对于文档的每个路径
宣布,改变这一点.
操作可以用 x-mcp 供应商延伸. false 叶子
其工具出型号,以及 name, (中文(简体) ), title 财务报告和审定财务报表 description 替换这些
工具的部件.
已贬值的操作工具描述开始于 Deprecated.,一个 x-mcp 说明
包括,每个被折旧的属性、关系、过滤器和
排序工具输入中的密钥.
卖出它
来自无害环境管理或共同JS的运行时间负荷,仅需要客户端.
const { createJsonApiMcp } = require('@haddowg/json-api-mcp')
const mcp = createJsonApiMcp({ model: require('./mcp/v5.mcp.json') })
const session = await mcp.forRequest({ grantedScopes: token.scopes, context: { token } })
session.tools // answer tools/list with these
await session.callTool('albums_list', { sort: ['-releasedAt'], pageSize: 5 })
每个结果 structuredContent 是个类似API的信封 单项资源归来为
{ data },集合为 { data, links, meta } 只使用页形链接,删除为
{ data: null } 和只使用元的动作作为 { meta }。平地资源保持链接
类型名称,例如预先签名的上传 URL,在 links。 。 。 .
来自 1.2: 返回 { data } 返回地点 { item },创建或更新为
包起来 { data } 而不是光着身子回来 收藏品列出了它的资源
data 改为 items删除返回 { data: null } 而不是一行文字, a
纯元动作 { meta } 代替赤色元对象, 和一个 URL 动作
{ data: { url, type, expiresAt? } } 而不是赤裸的物体。 重新生成模型以获得
新形状。 1.2生成的模型仍然装入并保持了1.2的形状 输出计划
说明。 这个 移徙说明
掩护其他的.
范围过滤只计算打电话者凭其证书可以满足的安全要求
计划,文档的 oauth2 计划,除非你通过 credentialSchemes1. 范围、特点
闸口、信头和错误提示来自可选钩: scopeMatcher, (中文(简体) ), capabilities, (中文(简体) ),
includeOperation, (中文(简体) ), decorateTool, (中文(简体) ), requestInit 财务报告和审定财务报表 mapError见
MCP 工具指南。 。 。 .