mcpField
S
Schemastore

Schemastore

远程服务
pipeworx.io开发工具05 周前更新

关于 Schemastore

Schemastore 通过 JSON Schema Store 目录,为开发者提供常见配置和数据文件格式的 JSON Schema 查找与读取功能。它支持按文件名匹配、按名称精确查询及获取原始 Schema 文档。

主要功能

  1. 01浏览并筛选 Schema 目录
  2. 02按文件名查找匹配项
  3. 03按名称精确查询
  4. 04获取原始 JSON Schema

适用场景

  1. 01为 package.json 查找 Schema
  2. 02定位 GitHub Actions 工作流 Schema
  3. 03获取 OpenAPI 格式定义
  4. 04检查目录中的可用 Schema

MCP 相关

该项目以 MCP 服务形式提供 Schema 目录查询工具,MCP 客户端可通过 Pipeworx 网关连接,也可使用 npx 在本地以 stdio 方式运行。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://gateway.pipeworx.io/schemastore/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

@pipeworx/schemastore

JSON Schema Store MCP — 收录数百种知名配置/数据文件格式的 JSON Schema 目录(package.json、tsconfig.json、GitHub Actions 工作流、OpenAPI 等)。无需密钥。

属于 Pipeworx — 一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

  • list_schemas(filter?, limit?) — 列出目录条目;filter 是对名称/描述/fileMatch 进行不区分大小写的子字符串匹配
  • find_schema_for(filename) — 查找与给定文件名匹配的 Schema(例如 package.json、.github/workflows/ci.yml)
  • fetch_schema(url) — 从目录获取原始 JSON Schema 文档(由 schemastore 托管的 URL)
  • lookup(name) — 在目录中按名称精确查找

数据源

https://www.schemastore.org/api/json/catalog.json

快速开始

添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):

{
  "mcpServers": {
    "schemastore": {
      "url": "https://gateway.pipeworx.io/schemastore/mcp"
    }
  }
}
此端点实际提供的内容

https://gateway.pipeworx.io/schemastore/mcp 上的 tools/list 会返回上表中的工具, 以及 Pipeworx 共享元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。 因此,你看到的工具数量会多于上表所列:目前,单个套件端点会列出大约 30 个共享工具,以及该套件自身的工具。连接的 initialize 响应会说明其确切范围,是了解当天实际情况的权威依据。

这是有意设计的,并非意外复用。元工具可以让限定范围的连接回答此套件未涵盖的问题 — 通过 ask_pipeworx 跨整个目录进行路由 — 无需再添加第二个 MCP 服务。目前无法挂载不包含这些工具的套件端点;如果额外的 Schema 占用的上下文超过路由带来的收益,请连接完整网关一次,而不是连接多个套件端点。

或者连接完整的 Pipeworx 网关,直接列出每个套件的工具, 而不只是此套件的工具:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是哪些套件的工具会被直接列出;无论连接哪个端点,ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端?通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/list_schemas \
  -H 'Content-Type: application/json' \
  -d '{"filter":"github","limit":10}'

首次调用无需账户。检查任意工具:GET https://gateway.pipeworx.io/v1/tools/list_schemas。查找工具:使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行(无需网关账户)

此软件包也可以作为本地 stdio MCP 服务运行 — 无需 Pipeworx 账户,也无需经由网关:

{
  "mcpServers": {
    "schemastore": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-schemastore"]
    }
  }
}

或者直接运行,确认它可以启动:

npx -y @pipeworx/mcp-schemastore

它通过 stdin/stdout 使用 MCP,并响应 initialize/tools/list/tools/call, 仅提供此套件的工具 — 不包含上述网关连接额外提供的任何共享元工具。数据源相同、工具相同,但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你可以用通俗语言提问,而不是直接调用工具 — 此功能既适用于上面的套件端点,也适用于完整网关:

ask_pipeworx({ question: "your question about Schemastore data" })

网关会选择合适的工具并自动填写参数。

更多信息

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。