Mcp Cli Catalog

mcp-cli-catalog

一个用于发布你机器上 CLI 工具的 MCP 服务。编码 Agent 已经可以访问 shell，也擅长生成包含管道和筛选器的复杂命令。这个服务只是告诉它们有哪些工具可用，让它们更高效地使用 MCP 工具。

为什么

• 大模型编码 Agent 可以有效地通过管道串联 shell 命令，以筛选和重塑复杂数据。
• 将 CLI 工具声明为 MCP 工具，可以让大模型发现这些工具。

工作原理

• 此服务会将你的 CLI 工具公开为 MCP 工具定义，让大模型了解有哪些工具可用。
• 目录中定义的 MCP 工具只会指示大模型使用 shell，不会自行执行任何工具。
• Agent 需要访问 shell 才能实际运行命令。

安装

将此服务添加到你的 MCP 配置中（例如，用于 Claude Code）：

{
  "mcpServers": {
    "cli-catalog": {
      "command": "npx",
      "args": ["mcp-cli-catalog"]
    }
  }
}

也可以使用自定义目录路径：

{
  "mcpServers": {
    "cli-catalog": {
      "command": "npx",
      "args": ["mcp-cli-catalog", "--config", "./tools.json"]
    }
  }
}

配置工具

添加一个 JSON 目录文件（默认：~/.mcp-cli-catalog.json），列出你希望公开供发现的 CLI 工具：

{
  // JSON Comments are allowed.
  "tools": [
    {
      "name": "knowledge-base-search",
      "description": "Search full text across the knowledge base",
      "usage": "knowledge-base-search 'pattern' | head"
    },
    {
      "name": "knowledge-base-get",
      "description": "Get a knowledge base file",
      "usage": "knowledge-base-get path/to/file.md | sed -n '100,200p'\nknowledge-base-get path/to/file.md | rg 'TODO'"
    }
  ]
}

• 必须提供 name 和 description。
• usage（可选）会作为提示显示在响应中。
• command（可选）是要运行的确切字符串。如果省略，则使用工具的 name。
• 使用 --config <path> 或 MCP_CLI_CATALOG_FILE=<path> 指向其他目录。

测试

使用 MCP Inspector 测试你的服务配置：

npx @modelcontextprotocol/inspector npx mcp-cli-catalog

也可以使用自定义目录：

npx @modelcontextprotocol/inspector npx mcp-cli-catalog --config ./tools.json

开发

• npm run dev：直接从 src/index.js 运行
• npm run build：编译到 dist/index.js 并修复权限
• npm start：从 dist/index.js 运行构建后的服务

替代方案

Cloudflare 的“Code Mode”¹ 和 Anthropic 关于 MCP 代码执行的文章² 探讨了另一种解决 MCP 工具挑战的方法。它们的方案通过 SDK 向大模型提供 MCP 工具，由大模型编写代码来调用和处理这些工具。本项目采用更简单的方式：构建 CLI 工具，并通过 MCP 工具目录让它们可被发现。

---

1. Cloudflare，《Code Mode》，2025。
2. Anthropic，《Code execution with MCP》，2025。