MCP Services

MCP服务

多对多MCP服务器+用于AI代理的REST API。29个工具，涵盖网络抓取、SEO分析、代理内存、屏幕截图/PDF生成、域智能、内容提取、多链EVM区块链查询和安全工具包。

______________________________________________________________________

快速开始

使用托管版本（无需设置）

添加到您的MCP客户端配置（Claude Desktop、Cursor、OpenClaw等）：

{
  "mcpServers": {
    "mcp-services": {
      "url": "https://mcp.skills.ws/mcp/sse"
    }
  }
}

免费套餐：每天10次通话，无需身份验证。

自托管

npm install -g mcp-services
mcp-services
# -> running on http://localhost:3100

______________________________________________________________________

工具（29）

网络爬虫

SEO工具包

代理内存

屏幕截图和PDF

内容提取

领域智能

区块链（6条EVM链）

支持的链： 以太坊、Base、Arbitrum、乐观主义、多边形、Celo

安全工具包

安全工具在没有API密钥的情况下正常降级（仅启发式模式）。可选按键： VT_API_KEY, ABUSEIPDB_API_KEY, ETHERSCAN_API_KEY.

______________________________________________________________________

认证

三层——选择合适的一层：

API密钥

通过Stripe订阅以获得无限制的API密钥：

仅用于迁移，查询字符串API键(?apikey=)可以通过以下方式临时重新启用 ALLOW_APIKEY_QUERY=true。此模式已弃用；更喜欢 X-Api-Key.

# 1. Create checkout session
curl -X POST https://mcp.skills.ws/billing/checkout
# Returns: { "url": "https://checkout.stripe.com/..." }

# 2. Complete payment at the Stripe URL
# 3. You'll receive your API key on the success page (shown once only -- save it)

# 4. Use it
curl -H "X-Api-Key: mcp_your_key" "https://mcp.skills.ws/api/whois?domain=example.com"

x402每次通话付费

不需要帐户。在Base或Celo上使用USDC或USDT支付。x402兼容代理自动处理付款。

curl -H "X-Payment: " "https://mcp.skills.ws/api/screenshot?url=https://example.com"

______________________________________________________________________

REST API

所有工具也都可以作为REST端点使用：

# Web Scraping
curl "https://mcp.skills.ws/api/scrape?url=https://example.com"
curl "https://mcp.skills.ws/api/crawl?url=https://example.com&depth=2&maxPages=10"
curl "https://mcp.skills.ws/api/extract?url=https://example.com"

# SEO
curl "https://mcp.skills.ws/api/serp?keyword=mcp+server"
curl "https://mcp.skills.ws/api/onpage-seo?url=https://example.com"
curl "https://mcp.skills.ws/api/keywords?keyword=ai+agents"

# Memory
curl -X POST "https://mcp.skills.ws/api/memory" \
  -H "Content-Type: application/json" \
  -d '{"namespace":"my-agent","key":"greeting","value":"Hello world","tags":["demo"]}'
curl "https://mcp.skills.ws/api/memory?namespace=my-agent&key=greeting"
curl "https://mcp.skills.ws/api/memory/search?namespace=my-agent&query=hello"

# Domain Intelligence
curl "https://mcp.skills.ws/api/whois?domain=example.com"
curl "https://mcp.skills.ws/api/dns?domain=example.com&type=ALL"
curl "https://mcp.skills.ws/api/ssl?domain=example.com"

# Content
curl "https://mcp.skills.ws/api/screenshot?url=https://example.com&format=png"
curl "https://mcp.skills.ws/api/pdf?url=https://example.com"
curl "https://mcp.skills.ws/api/pdf2docx?url=https://example.com/document.pdf"

# Blockchain
curl "https://mcp.skills.ws/api/chain/balance?address=0x...&chain=ethereum"
curl "https://mcp.skills.ws/api/chain/erc20?address=0x...&token=0x...&chain=celo"

# Security
curl "https://mcp.skills.ws/api/security/url-scan?url=https://suspicious-site.com"
curl "https://mcp.skills.ws/api/security/wallet-check?address=0x...&chain=ethereum"
curl "https://mcp.skills.ws/api/security/contract-scan?address=0x...&chainId=1"
curl "https://mcp.skills.ws/api/security/email-headers?domain=example.com"
curl "https://mcp.skills.ws/api/security/threat-intel?ioc=8.8.8.8&type=ip"
curl "https://mcp.skills.ws/api/security/header-audit?url=https://example.com"
curl "https://mcp.skills.ws/api/security/vuln-headers?url=https://example.com"

______________________________________________________________________

环境变量

______________________________________________________________________

反向代理和客户端IP配置

mcp-services 默认为 TRUST_PROXY=false，这意味着应用程序会忽略 X-Forwarded-For 并使用直接套接字对等IP进行速率限制和空闲层内存命名空间。

启用 TRUST_PROXY 只有当您的部署实际上位于重写转发标头的可信反向代理/负载均衡器之后时。常见选项：

• TRUST_PROXY=1 当Node.js前面只有一个受信任的代理时
• TRUST_PROXY=loopback 用于本地代理设置
• TRUST_PROXY= （或逗号分隔的值）用于显式可信代理范围

启用信任代理后，Express将导出 req.ip 从 X-Forwarded-For 根据该信任政策。确保您的边缘代理：

1. 附加/设置有效 X-Forwarded-For 链条
2. 防止直接不受信任的客户端欺骗转发标头
3. 将真实客户端地址转发为中最左侧的IP X-Forwarded-For

如果 X-Forwarded-For 存在时 TRUST_PROXY=false，服务器会记录一个防御警告并忽略该标头。

对于生产，设置 SSE_ALLOWED_HOSTS 和 SSE_ALLOWED_ORIGINS 严格、明确的值（仅限您的公共MCP域和受信任的应用程序来源）。避免通配符或宽泛的内部主机列表。

部署强化检查表（推荐）

• 集 NODE_ENV=production
• 保持 ALLOW_APIKEY_QUERY=false （仅限标头身份验证）
• 配置 TRUST_PROXY 正确设置网络路径（不要盲目设置 true)
• 设置严格 SSE_ALLOWED_HOSTS 和 SSE_ALLOWED_ORIGINS
• 使用 REDIS_URL 用于多实例部署中的共享速率限制
• 旋转 ADMIN_SECRET 定期使用条纹键
• 保持 X402_TEST_MODE=0 生产中（由服务器强制执行）
• 坚持 KEYS_FILE, MEMORY_DB_PATH，以及 X402_TX_CACHE_FILE 论耐用存储
• 跑 npm audit CI和失败建立在高/关键漏洞之上

生产环境快速入门

cp .env.production.example .env
# then edit .env values for your domain, proxy topology, redis and secrets

条纹webhook边缘允许列表自动同步（nginx）

# Generate CIDR allowlist include from Stripe source and reload nginx
scripts/sync-stripe-webhook-ips.sh \
  --out /etc/nginx/snippets/stripe-webhook-allowlist.conf \
  --reload "systemctl reload nginx"

看 deploy/nginx/stripe-webhook.conf.example 对于webhook位置块。

______________________________________________________________________

安全

• SSRF保护：URL验证+DNS预解析+私有IP阻止+Puppeter请求拦截
• 域验证：正则表达式allowlist防止命令注入
• 输入净化：按IOC类型进行格式验证、地址格式检查、链分配列表
• 每个身份验证层的内存命名空间隔离（API密钥哈希、IP或x402）
• 免费套餐的价格限制
• 资源限制：最大并发浏览器数、SSE会话数、PDF大小上限、5MB响应正文限制
• 外部API获取的响应大小限制

______________________________________________________________________

建筑

                  +------------------------------------+
                  |          Express Server             |
                  |                                     |
                  |  +---------+    +--------------+    |
  MCP SSE ------->  | MCP SDK |    |  Auth Layer   |   |
                  |  |  (SSE)  |    | free/key/x402 |   |
                  |  +---------+    +--------------+    |
                  |                                     |
  REST API ------>  +--------------------------------+  |
                  |  |        29 Tool Handlers        |  |
                  |  | scrape | crawl | extract       |  |
                  |  | serp | onpage_seo | keywords   |  |
                  |  | memory (5) | screenshot | pdf  |  |
                  |  | html2md | ocr | whois | dns    |  |
                  |  | ssl | balance | erc20 | tx     |  |
                  |  | url_scan | wallet_check        |  |
                  |  | contract_scan | email_headers   |  |
                  |  | threat_intel | header_audit     |  |
                  |  | vuln_headers                    |  |
                  |  +--------------------------------+  |
                  |        |              |              |
                  |  +-----+----+  +-----+----------+   |
                  |  | Puppeteer|  | viem (6 RPCs)   |   |
                  |  | Chromium |  | whois-json      |   |
                  |  |          |  | dns/promises    |   |
                  |  |          |  | security.js     |   |
                  |  +----------+  +-----------------+   |
                  |                                     |
  Stripe -------->  +--------------------------------+  |
  Webhooks        |  |   Billing (stripe.js)          |  |
                  |  |   checkout -> key provisioning  |  |
                  |  +--------------------------------+  |
                  +------------------------------------+

堆栈

• 运行时间： Node.js 22+Express
• 浏览器： Puppeter（Chromium）-截图、PDF、OCR、html2md
• 块链： viem——通过公共RPC实现6个EVM链
• 安全： VirusTotal、AbuseIPDB、Etherscan、Honeypot.is、OTX AlienVault+启发式
• 付款： Stripe（订阅），x402协议（Base/Celo上的稳定币）
• MCP： @modelcontextprotocol/sdk 使用SSE运输
• 群众或部队的集合： 阿莱夫云 （分散计算）

许可证

麻省理工学院-- 提交媒体SARL