MCP Sed Awk

MCP sed/awk服务器

为模型上下文协议服务器提供安全的sed、awk和diff文本处理功能。

概述

此FastMCP服务器通过受控执行Unix文本处理实用程序为LLM提供高效的文件编辑和分析。令牌高效操作补充了grep功能，同时通过输入验证、目录白名单和资源限制实施严格的安全控制。

特性

• 模式替换 通过支持正则表达式的sed
• 文本转换 awk字段提取与处理
• 文件比较 具有统一的差分输出
• 预览操作 用于申请前的变更验证
• 目录白名单 访问控制
• 全面验证 防止命令注入、路径遍历、ReDoS攻击
• 资源强制执行 （文件大小限制、超时、内存上限）
• 审核日志记录 用于安全相关操作
• 与跨平台支持 （Linux GNU工具，macOS BSD工具）

需求

• Python 3.9或更高版本
• FastMCP 2.0+
• 系统二进制文件： sed, awk, diff （Linux/macOS上的标准配置）
• 在sed操作的目标目录中写入权限

安装

来自GitHub：

git clone https://github.com/William12556/mcp-sed-awk.git
cd mcp-sed-awk
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e .

在Claude Desktop中配置：

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sed-awk-mcp": {
      "command": "/path/to/mcp-sed-awk/venv/bin/mcp-sed-awk",
      "args": [
        "--allowed-directory", "/Users/your-username/Documents",
        "--allowed-directory", "/Users/your-username/Projects"
      ]
    }
  }
}

注： 替换 /path/to/mcp-sed-awk 根据实际安装路径。使用虚拟环境二进制文件的完整路径以确保可靠执行。

重新启动Claude Desktop以激活服务器。

可用工具

1. sed_替代品 -基于模式的查找和替换与自动备份
2. preview_sed -无损更改预览
3. awk变换 -字段提取和文本转换
4. 差异文件 -与统一差异输出进行文件比较
5. list_allowed_directories -显示可访问路径

文档

用户指南 -安装、配置、使用示例和故障排除

项目状态

版本1.0.0-初始版本

完整的：

• 设计基线（15个功能需求，15个非功能需求）
• 完整测试套件（100%通过率：51%单元测试覆盖率，19/19集成测试）
• 安全架构（验证、路径控制、资源限制、审计日志）
• 平台抽象（GNU/BSD兼容层）
• FastMCP集成（基于装饰器的工具定义）

重要通知

不能保证实际适用性。

该项目代表了使用Anthropic的Claude Desktop和Claude Code，使用编排框架进行系统软件开发，探索人工智能支持的软件开发。

发展

设置开发环境：

git clone https://github.com/William12556/mcp-sed-awk.git
cd mcp-sed-awk
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e ".[dev]"

运行测试：

# Unit tests with coverage
pytest tests/ --cov=src/sed_awk_mcp --cov-report=term-missing

# Integration tests only
pytest tests/integration/

# All tests with output capture
pytest tests/ -v

测试工件： 根据项目惯例，管道测试结果 workspace/test/result/pytest-result.txt 使用：

pytest tests/ | tee workspace/test/result/pytest-result.txt

许可证

版权所有（c）2025威廉·沃森。此作品根据MIT许可证获得许可。