MCP 服务器套装用于开发人员

一套强大的 Model Context Protocol (MCP) 服务器套件，旨在使 AI 助手（如Claude）能够与您的本地环境互动、执行代码并处理网络内容。

简介

MCP 服务器套件为开发人员提供了三个强大的工具，使 AI 助手能够与本地环境互动、执行代码并处理网络内容。以下是每个服务器的简要介绍：

1. 文件系统 MCP 服务器

• 功能：安全地与本地文件系统交互。
• 特性：
  • 防止目录遍历攻击，限制操作到指定目录。
  • 尊重现有文件权限，避免命令注入漏洞。
  • 记录所有修改并提供回滚机制。

2. Exec MCP 服务器

• 功能：在隔离环境中执行命令和脚本。
• 特性：
  • 支持多种编程语言的执行。
  • 配置资源限制，防止滥用。
  • 可选网络访问限制，确保安全。

3. Web 处理 MCP 服务器

• 功能：抓取网络内容并进行 AI 分析。
• 特性：
  • 使用 OpenAI API 和其他服务进行内容分析。
  • 支持指定允许的域名，防止意外爬虫。
  • 提供速率限制，避免过度使用。

安装与配置

安装指南

1. 文件系统服务器：

   docker build -t mcp/filesystem .
   

2. Exec 服务器：

   docker build -t mcp/exec .
   

3. Web 服务器：

   docker build -t mcp/web .
   

配置示例

在 AI 助手的配置文件中添加以下内容：

{
  "filesystem": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "--mount",
      "type=bind,src=/home/username/projects,dst=/fs",
      "mcp/filesystem",
      "/fs"
    ]
  },
  "exec": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "--mount",
      "type=bind,src=/home/username/projects,dst=/fs",
      "mcp/exec",
      "/fs"
    ]
  },
  "web": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "OPENAI_API_KEY=your_api_key",
      "-e",
      "BRAVE_API_KEY=your_brave_key",
      "mcp/web"
    ]
  }
}

使用场景

软件开发

• 代码分析与重构：Claude 可以帮助分析和重构大规模代码库。
• 特性实现：根据需求快速实现新功能。
• 调试：通过运行测试并分析日志来解决问题。
• 环境配置：设置和管理开发环境及依赖项。

数据分析

• 数据抓取与处理：从网络或本地数据源获取信息。
• 数据分析与可视化：执行复杂的数据分析任务并生成报告。
• 爬虫：有选择性地爬取指定网站内容。
• 报告生成：整合多源数据生成综合报告。

系统管理

• 命令执行：运行诊断命令检查系统状态。
• 软件管理：安装和配置新软件包。
• 文件操作：安全地进行文件和目录管理。
• 日志分析：解读系统日志以识别问题。

安全注意事项

由于这些服务器赋予了AI助手强大的能力，必须谨慎处理安全问题：

文件系统服务器

• 路径验证：防止恶意访问敏感目录。
• 权限控制：严格限制文件操作权限。
• 审计日志：记录所有文件修改以便追踪。

Exec 服务器

• 容器隔离：确保每个任务在独立的容器中运行。
• 资源配额：设置 CPU 和内存使用上限。
• 网络访问：限制容器的互联网访问，除非必要。

Web 服务器

• API 密钥保护：避免将密钥硬编码或泄露。
• 域名限制：指定允许爬取的网站列表。
• 速率控制：监控并限制请求频率，防止滥用。

贡献指南

欢迎开发者积极参与项目，贡献代码或提出改进意见。提交 Pull Request 时，请确保遵循项目规范和代码风格。

许可证

本项目使用 MIT 许可证，具体内容请参阅 LICENSE 文件。

作者信息

0ken
GitHub: https://github.com/0ken