Model Context Protocol (MCP) Server - Filesystem Implementation

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

这是一个使用 Echo 框架以 Go 编写的模型上下文协议（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",
    "params": {
      "arguments": {
        "path": "README.md"
      }
    }
  }'

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

免责声明

此实现仅供教学使用，未经适当的安全审查和加固，不应在生产环境中使用。