MCP 文件系统服务器实现

MCP 文件系统服务器实现

一个使用 Go 和 Echo 框架实现的教育性质的模型上下文协议(MCP)服务器,提供本地文件系统访问。

快速入门

  1. 安装依赖:确保已安装 Go 1.24 或更高版本。
  2. 克隆仓库:git clone https://github.com/Loag/mcp-server-test.git
  3. 安装依赖项:go mod tidy
  4. 启动服务:go run main.go
  5. 默认端口为 8080,可通过设置环境变量 PORT 修改。

示例操作

  • 发现服务器能力 使用命令: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"}}}'