工具描述
说清做什么，也说清不做什么。
名称、用途、必要上下文与调用条件帮助调用方选择工具；避免把说明写成宽泛的“访问所有业务”。
开源 · 插件与连接器打开参考连接器
把工具的能力，
接到智能的下一步。
一个清楚的工具描述，一套可以校验的输入，一份能继续使用的结果。连接器让不同系统之间的协作，有了共同的语言。
DISCOVERVALIDATE
CONNECT
调用方MCP
Client
Client
catalog.describe
一个工具，一份契约。
输入
dataset处理
read-only返回
schema + metadata从一个连接，
看清整个过程。
MCP Catalog Kit 将两份合成数据集的字段信息，暴露为一个只读工具。切换数据集，查看实际参数与对应返回；下载包内附带同样的本地示例。
catalog.describe示例数据 · 本地契约预览
请求参数
{
"name": "catalog.describe",
"arguments": {
"dataset": "orders"
}
}仅允许列出的数据集，拒绝额外参数。
返回的数据结构
3 条合成记录| 字段 | 类型 |
|---|---|
order_id | string |
region | string |
amount | number |
readOnlyHintstructuredContent
页面展示的是本地示例映射，不连接你的数据库。工具提示不替代真实系统的授权检查。
MCP Catalog Kitv0.1.0 · Node.js 20+ · MCP 2025-11-25 · MIT
下载连接器源码ZIP · 4.6 KB插件可以小。
契约不能含糊。
从本地示例走向业务连接器，要补全的不是一个地址，而是每一次调用的责任。
输入与权限
输入结构与调用权限分别检查。
类型校验不能代替授权。连接真实系统时，按主体、数据范围与动作约定访问边界；凭证留在受控运行环境。
结果与异常
让调用方知道下一步如何处理。
返回可理解的数据结构与可区分的失败信息。区分参数错误、执行失败和业务不满足，避免把异常伪装为成功数据。
把连接，
放到本地跑一遍。
解压下载包，在目录内执行。消息样例会完成初始化、工具发现和一次目录读取；测试覆盖未初始化、无效参数与未知数据集。
无需安装依赖 · 无需密钥
node server.mjs < requests.jsonl
node --test server.test.mjs范围：stdio + 单个只读工具。正式接入仍需服务认证、运行监控、版本兼容与业务权限设计。
阅读完整运行说明 ↗从协议，继续深入。
本参考包固定使用 MCP 2025-11-25；以上为对应版本的官方规范。