Modern Cli MCP

🚀 现代CLI MCP服务器

现代CLI MCP服务器向AI/LLM代理公开了107种现代CLI工具。它提供了对文件系统、Git托管平台、容器、Kubernetes和数据转换工具的结构化JSON - RPC访问，所有输出均为JSON格式，便于AI处理。

🚀 快速开始

Claude桌面版 / Claude代码版

将以下内容添加到您的MCP配置中：

选项1：Nix（推荐）

{
  "mcpServers": {
    "modern-cli": {
      "command": "nix",
      "args": ["run", "github:NacoSolutions/modern-cli-mcp", "--"]
    }
  }
}

选项2：Docker

{
  "mcpServers": {
    "modern-cli": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/nacosolutions/modern-cli-mcp"]
    }
  }
}

选项3：二进制文件

{
  "mcpServers": {
    "modern-cli": {
      "command": "/path/to/modern-cli-mcp"
    }
  }
}

✨ 主要特性

• 15个组中的107种工具：涵盖文件系统、搜索、Git（GitHub/GitLab）、容器、Kubernetes和数据处理等方面。
• AI优化输出：默认输出JSON格式，便于结构化解析。
• 访问控制：使用.agentignore文件控制AI代理可以访问的文件。
• 零配置：Nix捆绑了所有依赖项，无需手动安装工具。

📦 安装指南

使用Flakes的Nix（推荐）

在Determinate Nix中，Flakes默认启用。对于标准Nix，可使用--experimental-features 'nix-command flakes'启用，或添加到~/.config/nix/nix.conf中：

experimental-features = nix-command flakes

直接运行（无需安装）：

nix run github:NacoSolutions/modern-cli-mcp

安装到配置文件：

nix profile install github:NacoSolutions/modern-cli-mcp

添加到flake.nix：

{
  inputs.modern-cli-mcp.url = "github:NacoSolutions/modern-cli-mcp";

  # 在输出中使用
  outputs = { self, nixpkgs, modern-cli-mcp }: {
    # 添加到包、开发环境等
  };
}

使用FlakeHub的Nix

FlakeHub提供了带有语义版本控制的版本化flake引用。

通过CLI添加到flake.nix：

fh add NacoSolutions/modern-cli-mcp

或手动添加：

{
  inputs.modern-cli-mcp.url = "https://flakehub.com/f/NacoSolutions/modern-cli-mcp/*.tar.gz";
}

运行特定版本：

nix run "https://flakehub.com/f/NacoSolutions/modern-cli-mcp/0.2.tar.gz"

不使用Flakes的Nix（经典方式）

对于未启用flakes的Nix安装，该仓库通过flake - compat包含了一个default.nix：

从tarball构建：

nix-build https://github.com/NacoSolutions/modern-cli-mcp/archive/main.tar.gz -A defaultNix.default
./result/bin/modern-cli-mcp

或克隆并在本地构建：

git clone https://github.com/NacoSolutions/modern-cli-mcp
cd modern-cli-mcp
nix-build
./result/bin/modern-cli-mcp

安装到配置文件：

nix-env -if https://github.com/NacoSolutions/modern-cli-mcp/archive/main.tar.gz -A defaultNix.default

Docker

docker pull ghcr.io/nacosolutions/modern-cli-mcp
docker run --rm -i ghcr.io/nacosolutions/modern-cli-mcp

从源代码（Cargo）安装

需要将CLI工具分别安装到PATH中：

cargo install --git https://github.com/NacoSolutions/modern-cli-mcp

💻 使用示例

可用工具（70 +）

文件系统

搜索

Git托管平台

容器

Kubernetes

数据转换

网络

系统

差异/Git

实用工具

🔧 技术细节

架构

src/
├── main.rs           # 入口点，MCP服务器设置
└── tools/
    ├── mod.rs        # 工具注册和路由
    └── executor.rs   # 工具执行逻辑

服务器使用结构化的JSON输入/输出包装CLI工具。每个工具：

1. 通过JSON Schema验证参数
2. 构建适当的命令
3. 执行并捕获输出
4. 返回结构化结果

配置

Nix包捆绑了所有CLI工具。通过cargo运行时，确保工具在PATH中。

环境变量

• RUST_LOG - 日志级别（默认：info）

.agentignore

使用.agentignore文件控制AI代理可以访问的文件。使用gitignore语法，但独立操作 - 工具仅遵循.agentignore，而不是.gitignore。

模式来源（按优先级排序）：

1. ~/.config/agent/ignore - 所有项目的全局模式
2. .agentignore - 每个目录的模式（从工作目录向上查找）

示例.agentignore：

# 秘密和凭证
*.secret
.env*
secrets/
credentials.json

# 大型生成文件
node_modules/
target/
*.min.js

# 敏感数据
*.pem
*.key

行为：

• 被阻止的路径返回错误：Path is blocked by .agentignore: /path/to/file
• 搜索工具（fd、rg、ast - grep）自动应用忽略模式
• 子目录中的模式扩展（而不是替换）父目录的模式

📄 许可证

本项目采用MIT许可证。