返回 MCP 目录
public公开dns本地运行

mcp-servers-for-coders

一套强大的MCP服务器套件,使AI助手能够与本地环境交互、执行代码和处理网页内容

article

README

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

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 密钥保护:避免将密钥硬编码或泄露。
  • 域名限制:指定允许爬取的网站列表。
  • 速率控制:监控并限制请求频率,防止滥用。

🔧 技术细节

本项目使用三个不同的服务器,分别负责文件系统交互、命令执行和网络内容处理。每个服务器都有其独特的安全机制和功能特性,通过 Docker 进行容器化部署,确保了环境的一致性和隔离性。同时,通过配置文件可以灵活地调整服务器的参数和权限,以满足不同的使用场景。

📄 许可证

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

👨‍💻 作者信息

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

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端