Use HTTP MCP

使用 HTTP MCP 工具

本 skill 提供使用 Node.js 发送 HTTP 请求、调用 REST API、测试接口的完整指南。基于原生 fetch API，无需额外依赖。

概述

HTTP MCP 工具使用 Node.js 18+ 内置的 fetch API，支持：

• 发送 GET/POST/PUT/DELETE/PATCH 等 HTTP 请求
• 处理 JSON 数据和表单数据
• 支持 Basic Auth、Bearer Token、API Key 等认证
• 文件上传/下载
• 设置请求头和超时
• MCP 服务器交互（获取工具列表、调用工具）

快速开始

# GET 请求
node skill.js get <url>

# POST 请求（JSON）
node skill.js post <url> '{"key": "value"}'

# 带认证
node skill.js get <url> -u <user>:<pass>           # Basic Auth
node skill.js get <url> -b <your-token>            # Bearer Token
node skill.js get <url> -H "X-API-Key: <key>"      # API Key

# 保存响应
node skill.js get <url> -o output.json

# 显示响应头
node skill.js get <url> -i

# 调试模式
node skill.js get <url> -v

HTTP 方法示例

# GET
node skill.js get https://api.example.com/users

# POST JSON
node skill.js post https://api.example.com/users '{"name": "张三", "age": 25}'

# POST 表单
node skill.js post https://api.example.com/login -f "username=<user>&password=<pass>"

# PUT
node skill.js put https://api.example.com/users/1 '{"name": "李四"}'

# DELETE
node skill.js delete https://api.example.com/users/1

# PATCH
node skill.js patch https://api.example.com/users/1 '{"age": 26}'

选项说明

MCP 服务器支持

本工具支持与 MCP (Model Context Protocol) 服务器交互。

获取 MCP 工具列表

# 自动检测并获取工具列表
node skill.js get <mcp-server-url> --mcp-tools

# 带认证
node skill.js get <mcp-server-url> -H "Authorization: Bearer <your-token>" --mcp-tools

工具会自动尝试以下方式：

1. REST API 端点 - 尝试 GET /mcp（某些服务可能使用 /api/mcp）
2. MCP JSON-RPC 协议 - 使用 /mcp 端点进行 initialize + tools/list

MCP JSON-RPC 协议完整调用流程

重要: 许多 MCP 服务器需要使用 JSON-RPC 协议并维护会话状态。

步骤 1: 初始化会话（获取 Session ID）

# 初始化并从响应头获取 mcp-session-id
node skill.js post <mcp-server-url>/mcp \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -i \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {
        "name": "use-http-mcp",
        "version": "1.0.0"
      }
    }
  }'

关键点:

• -i 显示响应头，包含 mcp-session-id
• 必须包含 Accept: application/json 头，否则返回 406
• 记录响应头中的 mcp-session-id 值

步骤 2: 使用 Session ID 调用工具

# 获取工具列表
node skill.js post <mcp-server-url>/mcp \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "mcp-session-id: <session-id>" \
  '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'

# 调用具体工具
node skill.js post <mcp-server-url>/mcp \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "mcp-session-id: <session-id>" \
  '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "<tool-name>",
      "arguments": {
        "query": "<搜索关键词>"
      }
    }
  }'

JSON-RPC 协议规范

必需的请求头

Authorization: Bearer <your-token>     # 认证令牌
Content-Type: application/json         # 请求内容类型
Accept: application/json               # 响应内容类型（必须！）
mcp-session-id: <session-id>           # 会话 ID（initialize 后必需）

常见错误处理

调用 REST API 风格的 MCP 工具

# 直接调用工具端点
node skill.js post <mcp-server-url>/tools/<tool-name> \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  '{"param1": "value1"}'

# GET 请求工具
node skill.js get "<mcp-server-url>/tools/search?query=关键词" \
  -H "Authorization: Bearer <your-token>"

文件操作

# 保存响应到文件
node skill.js get <url> -o response.json

# 从文件读取请求体
node skill.js post <url> @request.json

# 上传文件
node skill.js post <url> --file document.pdf

常见问题

Q: 为什么 MCP 请求返回 406？ A: 缺少 Accept: application/json 请求头

Q: 为什么 MCP 请求返回 400 Missing session ID？ A: JSON-RPC 协议需要在请求头中包含 mcp-session-id

Q: 如何处理 HTTPS 证书错误？ A: 使用环境变量 NODE_TLS_REJECT_UNAUTHORIZED=0（不推荐生产环境）

Q: 如何设置代理？ A: 使用环境变量 HTTP_PROXY 和 HTTPS_PROXY

Q: 支持哪些认证方式？ A: Basic Auth、Bearer Token、API Key、OAuth 2.0（通过请求头）

环境要求

• Node.js 18 或更高版本
• 不支持 WebSocket
• 不支持浏览器 CORS（运行在服务端）

适用场景

• API 测试和调试
• 自动化脚本
• CI/CD 流程
• 数据采集
• MCP 服务器交互