delx-agent-utilities

Delx Agent 工具集

为 AI Agent 提供的无状态实用工具 — URL/HTTP、DNS/RDAP、x402、JWT、编码、解析、正则表达式、cron。
本地优先。无需 API 密钥。结果确定。

mcp-name: io.github.davidmosiah/delx-agent-utilities

---

项目简介

89 个无状态实用工具，涵盖 AI Agent 经常使用的功能：URL 健康检查、网页内容提取、MCP 就绪状态、x402 服务发现、忠诚度奖励报价、JWT 检查、DNS / RDAP 查询、JSON / CSV 转换、哈希 / base64、cron 描述等。

• 无状态 — 每次调用相互独立；没有会话、缓存或数据库。
• 无需 API 密钥 — 仅使用公共端点（rdap.org、dns.google，以及用户提供的 URL）。
• 结果确定 — 不使用大模型，不进行模型调用，不产生模糊输出。
• 快速 — 大多数工具耗时 < 100ms；联网工具在设置超时的情况下耗时 < 5s。
• 原生支持 MCP — 提供 Agent 就绪状态清单、连接状态和隐私审计。

此软件包从 Delx Protocol MCP 服务中拆分出来，让任何 AI 构建者都能直接使用这套工具，而无需依赖 Delx 运行时。公开的产品和协议信息请参阅 ontology.delx.ai/utilities。

HTTP（v2 无状态）

不提供。Python FastMCP 扩展仅支持 stdio。添加 Streamable HTTP 需要额外配置 Starlette /health，而不只是启用一个标志，因此仍记为暂不支持（google-ads-intent-mcp 也一样）。这些工具本身已经是请求无状态的。

安装

pipx install "delx-agent-utilities[mcp]"

CLI 入口点：delx-agent-utilities、delx-utils（别名）、delx-utils-mcp（MCP 服务）。

快速使用

在 MCP 客户端中使用（Claude Desktop、Cursor、Hermes、OpenClaw）

{
  "mcpServers": {
    "delx-utils": {
      "command": "delx-utils-mcp"
    }
  }
}

90 个工具将立即可用，另有三个 Agent 就绪状态接口：

• delx_utilities_manifest
• delx_utilities_connection_status
• delx_utilities_privacy_audit

从 CLI 使用

delx-utils manifest
delx-utils list-tools
delx-utils show util_url_health
delx-utils call util_url_health --json '{"url":"https://example.com"}'

从 Python 使用

import asyncio
from delx_agent_utilities import call_util_tool, list_util_tool_schemas

result = asyncio.run(call_util_tool("util_url_health", {"url": "https://example.com"}))
print(result["status_code"], result["latency_ms"])

schemas = list_util_tool_schemas()
print(f"{len(schemas)} tools available")

90 个工具

编码与解析（15）

util_json_validate、util_token_estimate、util_uuid_generate、util_timestamp_convert、util_base64、util_hash、util_regex_test、util_cron_describe、util_http_codes、util_timezone_lookup、util_unit_convert、util_business_days、util_jwt_inspect、util_csv_to_json、util_json_to_csv

网页内容提取（6）

util_page_extract、util_open_graph、util_links_extract、util_forms_extract、util_contact_extract、util_feed_discover

网络探测（8）

util_url_health、util_robots_inspect、util_sitemap_probe、util_tls_inspect、util_security_txt_inspect、util_http_headers_inspect、util_dns_lookup、util_rdap_lookup

x402 / API 情报（6）

util_x402_server_probe、util_x402_resource_summary、util_x402_server_audit、util_api_health_report、util_openapi_summary、util_mcp_server_readiness_report

身份 / 联系方式（1）

util_email_validate

综合报告（8）

util_website_intelligence_report、util_domain_trust_report、util_docs_site_map、util_pricing_page_extract、util_company_contact_pack、util_api_integration_readiness、util_login_surface_report、util_content_distribution_report

商务工作流

util_loyalty_reward_quote

公共数据和身份（4）

util_vin_decode、util_wmi_decode、util_lei_lookup、util_inflation_calculator

本地文本、数据和标识符（35）

util_holidays、util_slugify、util_mime_lookup、util_color_convert、 util_ip_classify、util_cidr_contains、util_ulid_generate、 util_html_strip、util_semver_compare、util_word_count、 util_markdown_to_text、util_duration_parse、util_case_convert、 util_query_string、util_url_join、util_percent_change、util_clamp、 util_luhn_check、util_isbn_check、util_diff_lines、util_levenshtein、 util_similarity、 util_normalize_whitespace、util_extract_urls、util_extract_emails、 util_url_encode、util_hex_convert、util_number_base、util_dedupe_lines、 util_sort_lines、util_random_int、util_rot13、util_text_truncate、 util_reading_time、util_random_choice

销售驱动的本地预检工具（6）

util_seeded_random_sample、util_base_gas_budget_check、 util_dns_record_diff、util_http_header_diff、 util_x402_payment_preflight、util_image_result_contract_check

这 6 个预检工具是根据外部商务销售汇总数据选出的。 它们仅为本地实现：定价、x402 交付、遥测和退款责任仍由 Delx Commerce 承担。

每个工具的完整输入架构可通过 delx-utils show <tool> 或 Python 中的 UTIL_TOOL_SCHEMAS["<tool>"] 查看。

隐私立场

无 API 密钥。无遥测。无状态。 网络工具仅调用：

• 用于 RDAP 查询的 rdap.org/domain/<domain>
• 用于 DNS-over-HTTPS 的 dns.google/resolve
• 其他所有操作均使用用户提供的 URL

调用 delx_utilities_privacy_audit（或 delx-utils privacy-audit），即可在调用任何网络工具前，以 JSON 格式查看完整的隐私立场。

架构

src/delx_agent_utilities/
├── __init__.py          # public re-exports
├── agent.py             # manifest / status / privacy_audit
├── cli.py               # CLI argparse
├── dispatcher.py        # call_util_tool, _normalize_util_args
├── mcp_server.py        # FastMCP server
├── schemas.py           # public re-export of UTIL_TOOL_NAMES / SCHEMAS
└── _internal/           # implementation, not stable across versions
    ├── _helpers.py
    ├── _schemas.py
    ├── _tools_encoding.py
    ├── _tools_cron.py
    ├── _tools_http_codes.py
    ├── _tools_sales_led.py
    ├── _tools_web.py    # roadmap: split into web/network/x402/composite in v0.2.0
    └── _tools_jwt_csv.py

路线图

• v0.2.0 — 将 _internal/_tools_web.py（1k LOC）拆分为按领域划分的模块：_tools_web_extract.py、_tools_network.py、_tools_x402.py、_tools_composite.py。
• 使用按工具拆分的单元测试（每个工具对应一个文件）替代仅包含冒烟测试的测试套件。
• 可选复用 httpx.AsyncClient，用于批量探测。
• 通过环境变量配置各工具的超时时间（DELX_UTILITIES_DEFAULT_TIMEOUT_S、DELX_UTILITIES_URL_HEALTH_TIMEOUT_S，等等）。

来源

最初属于 Delx Protocol MCP 服务。于 2026-05-09 提取为独立的开源软件包，让任何 AI 构建者都能使用这套工具集，而无需依赖 Delx Protocol 运行时。

Delx Protocol 本身（恢复 / 心跳 / 身份 / 治理原语）仍为闭源；本软件包是其底层的开放式实用工具层。

贡献

欢迎提交 PR — 请参阅 CONTRIBUTING.md。以下是一些有帮助的改进方向：

• 新增符合“无状态 / 无 API 密钥 / 确定性”规则的实用工具。
• 按照上述 v0.2.0 路线图拆分 _internal/_tools_web.py。
• 为每个工具编写单元测试。

📧 联系与支持

• 📨 [email protected] — 一般咨询、集成协助、合作事宜
• 🐛 错误报告 / 功能请求 — GitHub Issues
• 🐦 最新动态 — X 上的 @delx369
• 🌐 网站 — wellness.delx.ai

许可证

MIT — 详见 LICENSE。

如果这个工具包对你的 Agent 工作流有所帮助，请 给仓库点个星标。星标能让其他 AI 构建者更容易发现这个项目，也能帮助 Delx 持续开发本地优先的 Agent 基础设施。

作者

David Mosiah — @delx369 — 在 Delx 构建自主 AI Agent 的协议层。