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

这是一个使用Go语言和Echo框架实现的教育性质的模型上下文协议（MCP）服务器。该服务器通过MCP协议提供对本地文件系统的访问。

概述

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

功能

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

安全注意事项

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

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

入门指南

先决条件

• Go 1.24或更高版本

安装

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

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

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",