Tool Lint

MCP运维云端

提供方 jeevesbot-io · 包名 tool-lint

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

tool-lint是一个用于验证和评分AI工具定义的生产就绪检查工具,支持MCP、OpenAI和Anthropic等多种格式。

一句话选型结论

按资料字段整理

Tool Lint 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

AI工具检查TypeScript本地部署工具定义验证多格式支持生产就绪

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx tool-lint check tools.json

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Tool Lint当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方jeevesbot-io上游标注的维护方 jeevesbot-io
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时tool-lint · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.7 KB
来自项目仓库与上游目录的原文,未做删改

工具棉绒

用于AI工具定义的生产就绪的过梁。验证并评分MCP工具定义、OpenAI函数调用模式和Anthropic工具使用块,以提高清晰度、完整性和代理友好性。


为什么使用工具棉绒?

人工智能代理的性能取决于它们所提供的工具。定义不清的工具会导致:

  • 代理人困惑 --模糊的描述导致工具选择不正确
  • 浪费的代币 --名称不明确和缺少上下文会增加重试次数
  • 运行时错误 --缺少或无效的参数会中断执行
  • 用户体验不佳 --代理失败会损害用户信任

工具棉绒 通过执行工具定义的最佳实践,在这些问题到达生产环境之前发现它们。


特性

✅ 多格式支持 --MCP、OpenAI和Anthropic工具模式\
✅ 12+综合规则 --捕捉常见的反模式\
✅ 智能评分系统 --每个工具0-100分,输出颜色编码\
✅ 多种输出格式 --用于CI集成的文本、JSON和SARIF\
✅ 灵活的输入 --文件、目录、globs或stdin\
✅ 可配置的 --忽略规则,设置最低分数,自定义严重程度\
✅ 生产就绪 --TypeScript,严格模式,全面测试


安装

全局安装(推荐)```bash

npm install -g tool-lint


### 本地安装```bash
npm install --save-dev tool-lint

无需安装即可运行```bash

npx tool-lint check tools.json


______________________________________________________________________

## 快速开始

### 基本用法```bash
# Check a single file
tool-lint check tools.json

# Check multiple files
tool-lint check tools/*.json

# Check with minimum score threshold
tool-lint check tools.json --min-score 80

# Output as JSON
tool-lint check tools.json --format json

# Output SARIF for CI integration
tool-lint check tools.json --format sarif > results.sarif

查看可用规则```bash

tool-lint rules


### 示例输出```
$ tool-lint check tools.json

✓ get_user_profile [92/100]
• 3 rules passed
• Well-structured tool definition

✗ search_products [64/100]
⚠ vague-tool-description: Missing concrete action verbs
⚠ too-many-params: 7 parameters (max 5 recommended)

Overall Score: 78/100
2 tools checked, 1 needs attention

棉绒规则

tool-lint执行12条综合规则:

工具级别规则

规则 描述 严重性
missing-tool-name 工具必须有名称 错误
missing-tool-description 工具必须有描述 错误
vague-tool-description 描述应使用具体动作动词(例如,“检索”、“创建”) 警告
oversized-description 描述应简洁(建议\<200个字符) 警告

参数规则

规则 描述 严重性
missing-param-description 所有参数都应该有描述 警告
vague-param-name 参数名称应清晰(避免 x, data, input) 警告
no-type-specified 所有参数都必须指定类型 错误
too-many-params 工具应具有≤5个代理理解参数 警告
duplicate-param-names 参数名称必须唯一 错误

架构规则

规则 描述 严重性
ambiguous-enum 枚举值应该不言自明 警告
nested-object-schema 避免深嵌套对象(最多2级) 警告
missing-required-field 应明确标记必需的参数 错误

支持格式

MCP(模型上下文协议)```json

{
"name": "get_weather",
"description": "Retrieves current weather data for a specific location",
"inputSchema": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "City name or ZIP code"
},
"units": {
"type": "string",
"description": "Temperature units",
"enum": ["celsius", "fahrenheit"]
}
},
"required": ["location"]
}
}


### OpenAI函数调用```json
{
&quot;name&quot;: &quot;get_weather&quot;,
&quot;description&quot;: &quot;Retrieves current weather data for a specific location&quot;,
&quot;parameters&quot;: {
&quot;type&quot;: &quot;object&quot;,
&quot;properties&quot;: {
&quot;location&quot;: {
&quot;type&quot;: &quot;string&quot;,
&quot;description&quot;: &quot;City name or ZIP code&quot;
}
},
&quot;required&quot;: [&quot;location&quot;]
}
}

人工工具使用```json

{
"name": "get_weather",
"description": "Retrieves current weather data for a specific location",
"input_schema": {
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "City name or ZIP code"
}
},
"required": ["location"]
}
}


______________________________________________________________________

## 配置

创建一个 `.toollintrc.json` 项目根目录中的文件:```json
{
&quot;rules&quot;: {
&quot;vague-tool-description&quot;: &quot;warn&quot;,
&quot;too-many-params&quot;: &quot;off&quot;
},
&quot;minScore&quot;: 75,
&quot;ignore&quot;: [
&quot;legacy-tools.json&quot;
]
}

配置选项

  • rules --设置规则严重性: &quot;error&quot;, &quot;warn&quot;,或 &quot;off&quot;
  • minScore --最低分数阈值(0-100)
  • ignore --要跳过的文件/模式
  • format --默认输出格式: &quot;text&quot;, &quot;json&quot;,或 &quot;sarif&quot;

CI/CD集成

GitHub操作```yaml

name: Lint AI Tools

on: [push, pull_request]

jobs:
lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: '18'
- run: npm install -g tool-lint
- run: tool-lint check tools/ --format sarif --min-score 80


### 预提交钩子```bash
#!/bin/bash
# .git/hooks/pre-commit

tool-lint check tools.json --min-score 75 || {
echo &quot;❌ Tool linting failed. Fix issues or use --no-verify to skip.&quot;
exit 1
}

例子

请参阅 examples/ 示例工具定义目录:

  • mcp-tools.json --MCP格式示例
  • openai-functions.json --OpenAI函数调用示例
  • anthropic-tools.json --拟人工具使用示例

运行linting示例:```bash
tool-lint check examples/*.json


______________________________________________________________________

## 命令行命令

### `check`

抓取一个或多个工具定义文件。```bash
tool-lint check  [options]

Options:
--format       Output format: text, json, sarif (default: text)
--min-score     Minimum score threshold (0-100)
--config       Path to config file
--ignore   Patterns to ignore (comma-separated)
--strict             Treat warnings as errors

rules

列出所有可用的lint规则及其说明。```bash
tool-lint rules [options]

Options:
--verbose Show detailed rule descriptions


### `init`

创建一个 `.toollintrc.json` 默认配置文件。```bash
tool-lint init

评分系统

每个工具根据以下因素获得0-100的分数:

  • 错误 ---每个20分(缺少名称、无效架构等)
  • 警告 ---每个得5分(描述模糊、参数太多等)
  • 奖金 --+10表示描述良好,参数名称清晰

分数解释

分数 · 状态 · 含义
90-100 · 🟢 优秀 · 生产就绪,遵循最佳实践
75-89 · 🟡 良好 · 建议稍作改进
60-74 · 🟠 需要解决的几个问题
0-59 · 🔴 差 · 主要问题,未准备好生产


最佳实践

✅ 良好的工具定义```json

{
"name": "send_email",
"description": "Sends an email to a recipient with subject and body content",
"inputSchema": {
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Recipient email address"
},
"subject": {
"type": "string",
"description": "Email subject line"
},
"body": {
"type": "string",
"description": "Email message content"
}
},
"required": ["to", "subject", "body"]
}
}


**为什么它很好:**

- 具体动作动词(“发送”)
- 明确、具体的参数名称
- 所有参数都有描述
- 明确标记的必填字段
- ≤5个参数(在这种情况下为3个)

### ❌ 工具定义不佳```json
{
&quot;name&quot;: &quot;email&quot;,
&quot;description&quot;: &quot;Does email stuff&quot;,
&quot;inputSchema&quot;: {
&quot;type&quot;: &quot;object&quot;,
&quot;properties&quot;: {
&quot;data&quot;: { &quot;type&quot;: &quot;string&quot; },
&quot;opts&quot;: { &quot;type&quot;: &quot;object&quot; }
}
}
}

问题:

  • 名称模糊(什么样的电子邮件操作?)
  • 描述模糊(“东西”没有帮助)
  • 通用参数名称(data, opts)
  • 缺少参数说明
  • 未指定必填字段
  • 没有架构的嵌套对象

发展

从源代码构建```bash

git clone https://github.com/jeevesbot-io/tool-lint.git
cd tool-lint
npm install
npm run build
npm link


### 运行测试```bash
npm test

项目结构```

tool-lint/
├── bin/
│ └── tool-lint.ts # CLI entry point
├── src/
│ ├── cli.ts # Command handlers
│ ├── parser.ts # Schema parser
│ ├── scorer.ts # Scoring engine
│ ├── types.ts # TypeScript types
│ ├── formatters/ # Output formatters
│ │ ├── text.ts
│ │ ├── json.ts
│ │ └── sarif.ts
│ └── rules/ # Lint rules
│ ├── missing-tool-description.ts
│ ├── vague-tool-description.ts
│ └── ... (12 rules total)
├── tests/ # Test suite
├── examples/ # Example tool definitions
└── README.md


______________________________________________________________________

## 常见问题解答

### Q: 我为什么需要这个?

**A.** 如果你正在构建使用工具(MCP服务器、OpenAI函数、Anthropic工具)的AI代理,定义不清的工具会浪费令牌、混淆代理并导致运行时错误。工具棉绒在生产前就发现了这些问题。

### Q: 我可以在CI/CD中使用它吗?

**A.** 对!使用 `--format sarif` GitHub Actions与GitLab CI集成的输出,或设置 `--min-score` 构建失败阈值。

### Q: 如何禁用规则?

**A.** 创建一个 `.toollintrc.json` 文件并将规则设置为 `&quot;off&quot;`:```json
{
&quot;rules&quot;: {
&quot;too-many-params&quot;: &quot;off&quot;
}
}

Q: MCP、OpenAI和Anthropic格式之间有什么区别?

A. 它们是定义工具参数的不同模式约定:

  • 主控程序 用途 inputSchema
  • 开放人工智能 用途 parameters
  • Anthropic 用途 input_schema

tool-lint支持这三种工具,并在内部对其进行规范化。

Q: 我可以延长规则吗?

A. 还没有,但计划在v2.0中支持自定义规则。现在,您可以分叉仓库并在其中添加自己的规则 src/rules/.


建造于

铸造厂 --自主建设者代理\
管道:Scout(3m)→ 研究员(3m)→ 规格(1m)→ 建筑商(9m)

构建统计信息:

  • 时长:约9分钟
  • 测试:23/23通过
  • 成本:0.57美元
  • 建造时间:2026-03-02

许可证

麻省理工学院


贡献

欢迎投稿!请打开问题或PR。

  1. 分叉回购
  2. 创建要素分支(git checkout -b feature/amazing-rule)
  3. 提交更改(git commit -m &#x27;Add amazing rule&#x27;)
  4. 推送到分支(git push origin feature/amazing-rule)
  5. 打开拉取请求

链接

  • github: https://github.com/jeevesbot-io/tool-lint
  • 问题: https://github.com/jeevesbot-io/tool-lint/issues
  • NPM: (即将推出)

制作🤖 铸造厂

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Tool Lint 怎么安装?

在客户端按下面的安装命令接入:npx tool-lint check tools.json。对应的包名是 tool-lint。装完在客户端配置里引用同一个包或端点。

Tool Lint 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Tool Lint 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Tool Lint 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Tool Lint 能提供哪些能力?

资料显示能力标签包括 多格式支持、TypeScript、生产就绪。具体工具清单以官方文档为准。

Tool Lint 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Tool Lint 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。