HTTP客户端MCP

一个基于HTTP标准的轻量级MCP,支持X OAuth集成和智能代理功能,适用于开发者和需要高效网络请求的场景。

  • by janwilmake
  • TypeScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 janwilmake/curlmcp

使用说明

curl MCP v2-您需要的最后一个MCP

基于HTTP标准构建的强大、轻量级的MCP,集成了X OAuth。

特性

  • 🔐 X OAuth集成 -与您的X帐户进行无缝身份验证
  • 🌐 通用HTTP客户端 -使用类似curl的语法向任何URL发出请求
  • 🔄 智能代理 -自动路由到流行网站的LLM优化版本
  • 📝 Markdown优先 -响应针对LLM消耗进行了优化
  • 🚀 Cloudflare员工 -快速、全球边缘部署
  • 🛡️ 安全 OAuth 2.1兼容PKCE

快速开始

MCP使用

添加到MCP客户端配置中:

{
  "mcpServers": {
    "curlmcp": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-fetch", "https://curlmcp.com/mcp"]
    }
  }
}

地方发展

# Clone and install
git clone https://github.com/janwilmake/curlmcp-v2
cd curlmcp-v2
npm install

# Start local development (requires x-oauth-provider running on :8787)
npm run dev

# Test with MCP Inspector
npx @modelcontextprotocol/inspector

使用示例

基本要求

GET /curl/api.github.com/users/janwilmake

带标题

GET /curl/api.example.com/data?header=Accept:application/json&header=User-Agent:curl-mcp

带数据的POST

GET /curl/api.example.com/submit?request=POST&data=name=test&data=value=123

X/GitHub集成

GET /curl/x.com/janwilmake
# Automatically routes to xymake.com with markdown headers

GET /curl/github.com/janwilmake/curlmcp
# Automatically routes to uithub.com with markdown headers

代理配置

  • x.com → xymake.com (降价优化X)
  • github.com → uithub.com (降价优化的GitHub)

认证

MCP需要X OAuth身份验证。首次使用时,您将被重定向到您的X帐户进行身份验证。访问令牌会自动用于需要身份验证的请求。

API参数

参数 说明 示例
request HTTP方法 POST, GET等等。
header 自定义标题 Accept:application/json
data 请求数据 key=value
user 基本身份验证 username:password
access_token OAuth令牌 默认情况下使用经过身份验证的用户令牌
include 包含响应标头 true
location 关注重定向 true

建筑

构建使用:

  • simplerauth 客户端 -OAuth集成
  • 与mcp -OpenAPI到MCP的转换
  • Cloudflare员工 -边缘部署

此版本消除了原始curlmcp的复杂性,同时添加了适当的身份验证和更简洁的架构。