Go MCP Request

🚀 MCP HTTP 请求工具 (Go版本)

MCP HTTP请求工具（Go版本）是一款为API测试、Web自动化和安全测试量身打造的全功能HTTP客户端。它基于MCP（模型上下文协议）服务器，具备完整的HTTP工具和详细的日志记录功能。采用Go语言编写，拥有更好的性能和更简单的部署方式。

🚀 快速开始

MCP HTTP请求工具使用便捷，你可以根据需求选择合适的安装方式，并按照使用方法进行操作。以下为你详细介绍安装和使用步骤。

✨ 主要特性

• 完整的HTTP方法支持：支持GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS等所有常见的HTTP方法。
• 高级安全测试：提供原始请求工具，可用于渗透测试、SQL注入、XSS测试等安全测试场景。
• 全参数支持：所有方法均支持设置Headers、Cookies、Body以及超时时间。
• 自动日志记录：所有请求和响应都会自动记录到 ~/mcp_requests_logs/ 目录下。
• 精确保证：原始模式可完全保留每个字符，确保请求的准确性。
• MCP兼容：兼容Claude Code、Cursor和其他MCP客户端。

📦 安装指南

选项1：下载二进制文件

你可以从 releases 页面 下载最新的二进制文件。

选项2：从源码构建

git clone https://github.com/pengcunfu/go-mcp-request.git
cd go-mcp-request
go build -o mcp-request main.go

💻 使用示例

基础用法

在 Cursor/Claude Code 中使用

你可以将其添加到MCP配置文件 (~/.cursor/mcp_servers.json 或类似文件) 中：

{
  "mcpServers": {
    "mcp-request": {
      "command": "./mcp-request",
      "type": "stdio"
    }
  }
}

或者，如果二进制文件已在你的PATH中，可使用以下配置：

{
  "mcpServers": {
    "mcp-request": {
      "command": "mcp-request",
      "type": "stdio"
    }
  }
}

可用工具

1. http_get - 全功能GET请求
2. http_post - 全功能POST请求
3. http_put - 全功能PUT请求
4. http_delete - 全功能DELETE请求
5. http_patch - 全功能PATCH请求
6. http_head - 全功能HEAD请求
7. http_options - 全功能OPTIONS请求
8. http_raw_request - 用于安全测试的原始HTTP请求

代码示例

# 基础GET请求
http_get("https://api.example.com/users")

# 带数据和请求头的POST请求
http_post(
    url="https://api.example.com/login",
    body='{"username":"test","password":"test"}',
    headers={"Content-Type": "application/json"}
)

# 使用原始请求进行安全测试
http_raw_request(
    url="https://vulnerable-site.com/search",
    method="POST", 
    raw_body="q=test' OR 1=1--",
    headers={"Content-Type": "application/x-www-form-urlencoded"}
)

🔧 技术细节

安全测试特性

http_raw_request 工具专为安全测试设计，具有以下特点：

• 绝对精确：每个字符都会被完全保留，确保请求的准确性。
• 无编码：特殊字符 (', ", \, %, &, =) 会原样发送，便于进行安全测试。
• 完整请求头：不会截断长cookies或tokens，保证请求头的完整性。
• 原始载荷：非常适合进行SQL注入、XSS、CSRF等安全测试。

日志记录

所有HTTP请求和响应都会自动记录到指定目录：

• 位置：~/mcp_requests_logs/
• 格式：采用JSON格式，包含时间戳和完整的请求/响应详情。
• 文件名：requests_YYYYMMDD_HHMMSS.log

查看日志的命令如下：

tail -f ~/mcp_requests_logs/requests_*.log

系统要求

• Go ≥ 1.21（从源码构建时需要）
• 无运行时依赖，仅需单一二进制文件即可运行。

📄 许可证

本项目采用MIT License。

贡献

欢迎大家为项目贡献代码！需要注意的是，此工具仅用于防御性安全测试和合法的API测试目的。