article
README
🚀 MCP 服务器套装用于开发人员
MCP 服务器套装是一套强大的工具,专为开发人员打造。它基于 Model Context Protocol (MCP),能让 AI 助手(如 Claude)与本地环境互动,执行代码,还能处理网络内容,为开发工作带来极大便利。
🚀 快速开始
MCP 服务器套件为开发人员提供了三个强大的工具,使 AI 助手能够与本地环境互动、执行代码并处理网络内容。
✨ 主要特性
1. 文件系统 MCP 服务器
- 功能:安全地与本地文件系统交互。
- 特性:
- 防止目录遍历攻击,限制操作到指定目录。
- 尊重现有文件权限,避免命令注入漏洞。
- 记录所有修改并提供回滚机制。
2. Exec MCP 服务器
- 功能:在隔离环境中执行命令和脚本。
- 特性:
- 支持多种编程语言的执行。
- 配置资源限制,防止滥用。
- 可选网络访问限制,确保安全。
3. Web 处理 MCP 服务器
- 功能:抓取网络内容并进行 AI 分析。
- 特性:
- 使用 OpenAI API 和其他服务进行内容分析。
- 支持指定允许的域名,防止意外爬虫。
- 提供速率限制,避免过度使用。
📦 安装指南
安装步骤
- 文件系统服务器:
docker build -t mcp/filesystem . - Exec 服务器:
docker build -t mcp/exec . - 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
微信扫一扫