MCP 服务器

MCP Servers for Coders

0kenx

开发者工具

访问服务器

README

程序员的 MCP 服务器

一套强大的模型上下文协议 (MCP) 服务器，旨在使像 Claude 这样的 AI 助手能够与您的本地环境交互、执行代码和处理 Web 内容。

概述

此存储库包含多个模型上下文协议 (MCP) 服务器，可显著扩展像 Claude 这样的 AI 助手的能力：

文件系统 MCP 服务器 - 支持安全的文件操作，具有高级差异跟踪和版本控制功能
执行 MCP 服务器 - 提供在隔离环境中执行命令和多语言脚本的功能
Web 处理 MCP 服务器 - 允许 Web 内容的获取、爬取和 AI 驱动的内容分析

这些服务器可以独立或协同工作，为 AI 助手提供直接在您的本地环境中执行复杂任务所需的工具，而不会牺牲安全性。

服务器

1. 文件系统 MCP 服务器

一个安全的 Python 服务器，使 AI 助手能够与您的本地文件进行交互，具有全面的文件管理和代码分析功能：

高级文件操作：使用多种访问方法（整个文件、行范围、基于关键字）读取和写入文件
智能代码分析：解析和理解跨多种语言的代码结构
版本控制：使用基于差异的编辑和选择性接受/拒绝功能跟踪所有 AI 所做的更改
安全至上的设计：路径验证、目录限制和权限检查
Git 集成：Git 感知的目录列表，遵循 .gitignore 规则
编辑器集成：Neovim 插件，实现无缝工作流程

关键安全特性：操作严格限制在明确允许的目录中，并进行完整的路径验证。

阅读更多关于文件系统 MCP 服务器的信息

2. 执行 MCP 服务器

一个强大的执行环境，允许 AI 助手在隔离的容器中运行代码和命令：

多语言支持：执行 Python、JavaScript、Rust、Go 和 Solidity 代码
智能包管理：自动检测和安装跨包管理器的所需依赖项
执行控制：设置超时、重定向输出流和处理长时间运行的进程
完整的开发环境：针对多种编程语言的预配置设置
安全控制：可配置的执行边界和资源限制

包含的开发环境：

Python 3.12：完整的数据科学堆栈（pandas、numpy、matplotlib）和开发工具（black、pytest）
JavaScript/TypeScript：Node.js v20，带有 npm 和 yarn
Rust：完整的工具链，带有 rustup、cargo 和扩展
Go 1.22.1：标准工具链和常用库
Solidity：Foundry 套件，带有 forge、cast 和 anvil

阅读更多关于执行 MCP 服务器的信息

3. Web 处理 MCP 服务器

一个复杂的 Web 内容检索和分析系统，使 AI 助手能够从互联网收集和处理信息：

灵活的内容检索：获取单个页面或爬取整个网站，具有可配置的参数
智能爬取：控制深度、页面限制、域限制和超时
AI 驱动的分析：使用 OpenAI 模型和可自定义的指令处理 Web 内容
多种输出格式：将结果转换为 Markdown、HTML、Text、JSON 或 Raw 格式
强大的错误处理：优雅地管理超时、重定向和连接问题
内容处理：自动处理具有大小限制和截断的大型页面

关键特性：无缝地将 Web 抓取与 AI 分析相结合，将原始 Web 内容转换为结构化的、有用的信息。

阅读更多关于 Web 处理 MCP 服务器的信息

开始使用

安装

所有服务器都支持 Docker 安装，这是大多数用户的推荐方法。每个服务器还在其各自的 README 中记录了替代安装方法。

Docker 安装（推荐）

# 克隆存储库
git clone https://github.com/0kenx/mcp-servers.git
cd mcp-servers

# 构建文件系统 MCP 服务器
cd filesystem
docker build . -t mcp/filesystem

# 构建执行 MCP 服务器
cd ../exec
docker build . -t mcp/exec

# 构建 Web MCP 服务器
cd ../web
docker build . -t mcp/web

使用 Claude 进行配置

要配置 Claude Desktop 或其他 Claude 界面以使用这些 MCP 服务器，请将它们添加到您的配置文件中：

{
  "mcpServers": {
    "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",
          "-e",
          "BRAVE_API_KEY",
          "mcp/web"
      ],
      "env": {
        "OPENAI_API_KEY": "sk-YOUR_OPENAI_KEY",
        "BRAVE_API_KEY": "YOUR_BRAVE_KEY"
      }
    }
  }
}

验证安装

配置完成后，验证服务器是否正常工作：

启动 Claude 并在界面中启用 MCP 服务器
使用基本命令测试每个服务器：
- 文件系统：要求 Claude 列出目录中的文件
- 执行：要求 Claude 运行一个简单的命令，例如 echo "Hello, World!"
- Web：要求 Claude 从 URL 获取内容