MCP Filesystem Go

安全文件系统MCP服务器

🚀 概述

这是一个安全的模型上下文协议（MCP）服务器实现，为AI模型提供受控的文件系统访问。它允许大型语言模型在明确定义的允许目录中安全地读取、写入和操作文件。

此项目是原始Go的实现 文件系统MCP服务器 根据Anthropic开发的模型上下文协议项目， 使用其他编辑器工具 以符合克劳德训练有素的期望。

📁 仓库

该项目是 公共Golang MCP服务器 存储库，其中包含Go中的各种MCP服务器实现。

✨ 特性

• 文件系统工具:

- 安全地读写文件 - 创建并列出目录 - 移动/重命名文件和目录 - 搜索与模式匹配的文件 - 获取详细的文件元数据

• 编辑器工具 新

- str_replace：手术绳索更换并验证 - insert：在特定行号处插入文本 - undo_edit：使用自动备份回滚文件更改

🔧 编辑器工具扩展

此服务器包括 编辑器工具 这与克劳德·索内特训练有素的期望相一致。这些工具解决了 第4027期 Claude试图使用标准MCP桌面环境中不存在的编辑工具。

为什么这很重要：Claude Sonnet已经接受了某些文件编辑原语的训练，这是Anthropic计算机使用功能的一部分。当这些功能不可用时，用户会遇到工具调用失败和工作流程降级的情况。这些编辑器工具弥合了这一差距。

🧰 可用工具

文件系统工具

编辑器工具

⚙️ 配置

服务器使用 config.json 应放置在与可执行文件相同的目录中或当前工作目录中的文件：

{
  "allowedDirectories": [
    "C:\\Users\\Username\\AppData\\Roaming\\Claude",
    "C:\\Users\\Username\\Documents",
    "D:\\Projects"
  ]
}

如果 config.json 文件不存在，将创建一个默认文件，将当前目录作为允许的目录。

🚀 入门指南

先决条件

• 达到1.21或更高（仅适用于从源代码构建）
• 对MCP架构的基本理解

安装

下载预构建的二进制文件

从以下网址下载适用于您平台的最新版本 发布页面.

Linux（x86_64）:

wget https://github.com/LaurieRhodes/mcp-filesystem-go/releases/latest/download/mcp-filesystem-linux-amd64
chmod +x mcp-filesystem-linux-amd64
sudo mkdir -p /usr/local/bin/mcp-servers/filesystem
sudo mv mcp-filesystem-linux-amd64 /usr/local/bin/mcp-servers/filesystem/mcp-filesystem

# Create config file with your allowed directories
sudo tee /usr/local/bin/mcp-servers/filesystem/config.json > /dev/null  /dev/null <<'EOF'
{
  "allowedDirectories": [
    "/Users/username/Documents",
    "/Users/username/Projects"
  ]
}
EOF

视窗:

下载 .exe 文件并将其放置在具有 config.json 文件：

{
  "allowedDirectories": [
    "C:\\Users\\Username\\Documents",
    "C:\\Users\\Username\\Projects"
  ]
}

从源头构建

标准版本（Windows）

# Clone the repository
git clone https://github.com/LaurieRhodes/mcp-filesystem-go.git
cd mcp-filesystem-go

# Build the server
go build -o mcp-filesystem-go.exe ./cmd/server

# Run the server (will use config.json)
mcp-filesystem-go.exe

Linux静态构建（推荐）

在Linux系统上，建议使用静态链接进行构建，以避免共享库依赖问题（例如。， libgo.so.23 错误）：

# Clone the repository
git clone https://github.com/LaurieRhodes/mcp-filesystem-go.git
cd mcp-filesystem-go

# Build with static linking (no external dependencies)
CGO_ENABLED=0 go build -o mcp-filesystem-go -ldflags="-s -w" ./cmd/server

# Verify static linking (should show "not a dynamic executable")
ldd mcp-filesystem-go

# Make executable and run
chmod +x mcp-filesystem-go
./mcp-filesystem-go

为什么是静态链接？ 当你在Linux上用动态链接编译Go程序时，它们依赖于共享库的特定版本（如 libgo.so.23).静态链接生成一个自包含的二进制文件，可以在任何Linux系统上运行，而不需要安装这些库。

MCP客户端配置

服务器需要 config.json 与可执行文件位于同一目录中的文件，以指定允许的目录。这种设计允许MCP服务器在多个客户端之间共享，而不是在每个客户端内管理配置。

在您的MCP客户端配置中（例如，Claude Desktop），请参考服务器二进制文件：

Linux/macOS示例

{
  "mcpServers": {
    "filesystem": {
      "command": "/usr/local/bin/mcp-servers/filesystem/mcp-filesystem"
    }
  }
}

Windows示例

{
  "mcpServers": {
    "filesystem": {
      "command": "C:\\path\\to\\mcp-filesystem.exe"
    }
  }
}

备注：更新您的路径 config.json 文件（位于可执行文件旁边）以匹配您允许的目录。

📊 实现细节

此服务器使用Go构建，并遵循模型上下文协议规范：

• 运输：使用stdio进行通信（从stdin读取JSON-RPC消息并将响应写入stdout）
• 模块化设计：MCP协议处理、文件系统操作和编辑器操作之间的清晰分离
• 全面的错误处理：详细的错误消息，便于调试
• 自动备份：编辑器操作在修改之前创建带时间戳的备份

#

📜 许可证

此MCP服务器根据原始的Anthropic MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。

👏 归因

这个项目是一个原始的港口 文件系统MCP服务器 由PBC的Anthropic开发，它是模型上下文协议项目的一部分。原始的Node.js实现可在 @modelcontextprotocol/server-filesystem.

编辑器工具扩展解决了社区在Claude Desktop的MCP工具可用性方面发现的差距。

🤝 贡献

此源代码是作为示例代码提供的，并不打算成为活动项目。请随时根据您的需求进行分叉和扩展。