Aparajithn/agent Utils

Agent Utils MCP 服务 🛠️

面向 AI Agent 的瑞士军刀式工具服务——通过 MCP（Streamable HTTP）+ REST API 提供 18 种工具。

在线地址： https://agent-utils-mcp.onrender.com

添加到 MCP 客户端

Claude Desktop / Cursor / Windsurf

添加到 MCP 配置中：

{
  "mcpServers": {
    "agent-utils": {
      "url": "https://agent-utils-mcp.onrender.com/mcp"
    }
  }
}

Smithery

smithery mcp add aparajithn/agent-utils

工具（18 种）

工具	描述
tool_json_validate	验证 JSON 字符串，返回解析结果或错误
tool_json_format	美化输出或压缩 JSON
tool_base64_encode	将字符串编码为 base64
tool_base64_decode	解码 base64 字符串
tool_hash_generate	生成 MD5、SHA256、SHA512 哈希
tool_uuid_generate	生成 UUID v4 或 v7
tool_url_parse	将 URL 解析为各个组成部分
tool_regex_test	测试正则表达式模式并返回匹配结果
tool_markdown_to_html	Markdown → HTML
tool_html_to_markdown	HTML → Markdown
tool_text_stats	统计词数、字符数和阅读时间
tool_slug_generate	根据文本生成 URL 安全的 slug
tool_datetime_convert	转换时区、格式和 Unix 时间戳
tool_cron_parse	生成易读的 cron 描述和接下来 N 次运行时间
tool_diff_text	生成两段文本之间的统一差异
tool_csv_to_json	将 CSV 转换为 JSON 数组
tool_json_to_csv	将 JSON 数组转换为 CSV
tool_jwt_decode	解码 JWT 负载（不验证）

REST API

所有工具也可通过 /api/v1/{tool_name} 下的 REST 端点使用。

# Hash a string
curl -X POST https://agent-utils-mcp.onrender.com/api/v1/hash_generate \
  -H "Content-Type: application/json" \
  -d '{"text": "hello world", "algorithm": "sha256"}'

# Generate UUID
curl -X POST https://agent-utils-mcp.onrender.com/api/v1/uuid_generate \
  -H "Content-Type: application/json" \
  -d '{"version": 4}'

# Convert datetime
curl -X POST https://agent-utils-mcp.onrender.com/api/v1/datetime_convert \
  -H "Content-Type: application/json" \
  -d '{"dt_string": "2025-01-01 12:00", "from_tz": "UTC", "to_tz": "America/New_York"}'

OpenAPI 文档：https://agent-utils-mcp.onrender.com/docs

服务发现

• Google A2A： /.well-known/agent-card.json
• Smithery： /.well-known/mcp/server-card.json
• OpenAPI： /openapi.json

定价

• 免费套餐： 每个 IP 每 24 小时 100 次请求
• 付费套餐： x402 协议——每次请求 $0.001，以 USDC（Base 网络）支付

使用 x402 付款

用完免费额度后，服务会返回 HTTP 402，并附带机器可读的付款要求（x402 v1）。任何支持 x402 的客户端都会自动付款并重试：

from x402_fetch import x402_fetch  # pip install x402-fetch
response = x402_fetch("https://agent-utils-mcp.onrender.com/api/v1/hash_generate", method="POST",
                      body={"text": "hello", "algorithm": "sha256"})

或者自行附加付款请求头：X-Payment 请求头必须包含一个经过 base64 编码的 JSON 信封，其中包含 EIP-3009 TransferWithAuthorization（Base 上的 USDC），并使用付款方的 EIP-712 密钥签名，金额必须准确，收款地址必须为服务的钱包，且 nonce 尚未使用。服务会在处理请求前通过密码学方式验证付款（恢复签名，并检查金额、收款方、截止时间及重放）。

付款配置（环境变量）

变量	默认值	用途
X402_WALLET_ADDRESS	（未设置——已禁用付费墙）	接收付款的钱包
X402_PRICE_MICROUSD	1000（$0.001）	每次请求的 USDC 最小单位价格
X402_NETWORK / X402_CHAIN_ID / X402_USDC_CONTRACT	base / 8453 / Base USDC	付款网络
X402_MAX_TIMEOUT_SECONDS	60	付款有效期
RATE_LIMIT_FREE	100	每个 IP 每 24 小时的免费请求数

收取收入（链上结算）

设置 X402_SETTLER_PRIVATE_KEY 后，每笔已验证的付款都会在几秒内在链上执行：EIP-3009 的 transferWithAuthorization 会提交到 Base 上的 USDC 合约，USDC 随即从付款方转入 X402_WALLET_ADDRESS。结算密钥不必需是收款钱包的密钥——EIP-3009 授权可由任何地址执行，因此可以使用专用的、仅用于支付 Gas 的临时密钥提交交易，同时将资金转入你的主钱包。该密钥只需在 Base 上有少量 ETH 余额用于支付 Gas。

变量	默认值	用途
X402_SETTLER_PRIVATE_KEY	(未设置 — 仅验证，不转移资金)	用于提交结算交易的密钥
X402_RPC_URL	https://mainnet.base.org	Base JSON-RPC 端点
X402_SETTLE_MIN_MICROUSD	0（立即结算每笔付款）	累积付款，直到待处理金额达到此值

结算失败时会采用指数退避策略重试；如果所有重试都失败，完整的付款授权会写入日志（CRITICAL），以便手动兑换——不会有任何付款被悄无声息地丢失。

技术栈

• Python 3.11 + FastAPI + MCP SDK（Streamable HTTP）
• 部署在 Render 上（自动扩缩容）
• GitHub：https://github.com/aparajithn/agent-utils-mcp

许可证

MIT