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測試目的。