Model Context Protocol (mcp) Server Filesystem Implementation

🚀 模型上下文协议（MCP）服务器 - 文件系统实现

本项目是一个使用Go语言和Echo框架实现的教育性质的模型上下文协议（MCP）服务器，它借助MCP协议为开发者提供对本地文件系统的访问能力。

🚀 快速开始

先决条件

• Go 1.24或更高版本

安装

1. 克隆仓库。
2. 安装依赖项：go mod tidy。
3. 运行服务器：go run main.go。

服务器默认将在8080端口启动，您可以通过设置PORT环境变量来更改端口。

✨ 主要特性

• 文件系统提供者：通过MCP工具和资源提供对本地文件系统的访问。
• 工具：
  • filesystem.list：列出目录内容。
  • filesystem.read：读取文件内容。
  • filesystem.write：向文件写入内容。
  • filesystem.delete：删除文件或目录。
• 资源：
  • filesystem.file：表示文件系统中的一个文件。
  • filesystem.directory：表示文件系统中的一个目录。

📚 详细文档

概述

模型上下文协议（MCP）是一个开放标准，它能让开发者构建安全的双向连接，用于数据源与AI工具之间的通信。本实现展示了如何创建一个提供本地文件系统访问权限的MCP服务器。

API 端点

• GET /：获取服务器信息。
• POST /v1/discover：发现服务器功能。
• POST /v1/call-tool：调用工具。
• POST /v1/load-resource：加载资源。

💻 使用示例

基础用法

发现服务器功能

curl -X POST http://localhost:8080/v1/discover

列出目录内容

curl -X POST http://localhost:8080/v1/call-tool \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "filesystem.list",
    "request_id": "req-123",
    "params": {
      "arguments": {
        "path": "."
      }
    }
  }'

读取文件内容

curl -X POST http://localhost:8080/v1/call-tool \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "filesystem.read",
    "request_id": "req-123",
    "params": {
      "arguments": {
        "path": "your_file_path"
      }
    }
  }'

🔧 技术细节

此实现包含基本的路径清理功能，以防止目录遍历攻击，但仅用于教育目的。在生产环境中，需要额外的安全措施，例如：

• 用户身份验证和授权
• 更强大的输入验证
• 速率限制
• 审计日志记录
• 隔离沙盒