Attester Oracle

io.github.maminihds由 GitHub 账号 maminihds 发布v0.2.0更新于 Oct 24, 2026

Verify PyPI and npm packages, symbols, and version diffs against real artifacts. Free, no account.

已验证Streamable HTTP可网页运行开发者工具安全与监控

概览

AI 生成的概览

一个托管预言机,让助手对照真实发布的制品核验 PyPI 与 npm 包、符号和版本差异,并附带签名证明。

可以做什么
检查 PyPI 或 npm 包名是否真实存在,未命中时给出仿冒邻近提示,并为每个结果附签名证明。检查某个函数、类或常量是否存在于包中,未命中时给出最接近的匹配建议。获取某个符号的精确签名、结构化参数、文档字符串摘要和弃用状态,可指定固定版本解析。对同一包的两个固定版本做符号级差异,并将变更归类为破坏性、新增或中性。
适用场景
适合在助手编写或审查导入第三方包的代码时,先确认包名、符号和签名确实存在,再安装或导入;也适合查看两个版本之间发生了什么变化。
运行要求
远程 streamable HTTP 端点;四个免费预言机工具无需安装、账号、API 密钥或钱包。免费额度为每个客户端 IP 每天 25 次调用,四个工具共享,UTC 00:00 重置。更高用量需使用付费 HTTP 路由,可通过 ATTESTER_API_KEY 使用预付额度,或用 BUYER_PRIVATE_KEY 进行 x402 支付。文档也说明了从源码本地以 stdio 安装的方式。
安装前请注意
免费额度按客户端 IP 计算且各工具共享,同一地址上的其他人可能将其用尽。付费路由按次收费;预付额度通过 Stripe 购买,x402 支付需要设置 BUYER_PRIVATE_KEY(持有 USDC 的 Base 钱包),包装器会自动用它签名付款。结果来自第三方服务的签名证明,若在意可信度应自行验证回执。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Attester Oracle,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.maminihds%2Fattester-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "attester-oracle": {
      "type": "http",
      "url": "https://attester.dev/mcp/"
    }
  }
}

README

attester-mcp

MCP server for attester.dev: verification and API-existence oracle tools for AI agents, callable from any MCP client (Claude Code, Cursor, Windsurf, LangChain, CrewAI).

Every result ships with a wallet-signed attestation you can verify without trusting us: POST https://attester.dev/receipts/verify is free.

Quickstart: free oracle tools, no keys

No install needed. Point your MCP client at the hosted endpoint:

json
{  "mcpServers": {    "attester": {      "url": "https://attester.dev/mcp/"    }  }}

Four oracle tools work immediately: no account, no API key, no wallet. You get 25 free calls per day per client IP, shared across the four tools, resetting 00:00 UTC. (This config block works for Claude Code, Claude Desktop, and Cursor; any MCP client that speaks streamable HTTP.)

ToolWhat it doesPrice per call
attester_package_existsDoes this PyPI/npm package name really exist? Typosquat-adjacency flags on misses.Free (25/day keyless); $0.002 paid
attester_symbol_existsDoes this function, class, or constant exist in the package? Closest-match suggestions on misses.Free (25/day keyless); $0.005 paid
attester_symbol_signatureExact signature, structured params, docstring, deprecation status, resolved at a pinned version.Free (25/day keyless); $0.01 paid
attester_version_diffSymbol-level diff between two pinned versions: added, removed, changed, breaking/additive/neutral.Free (25/day keyless); $0.02 paid

Run it locally instead (stdio): install from source with pip install git+https://github.com/maminihds/attester-mcp.git, then use "command": "attester-mcp" in the config above. A zero-install uvx attester-mcp command lands once the package is published to PyPI.

Steer your agent: CLAUDE.md / Cursor Rules snippet

- Before installing or importing a package, call attester_package_exists (and attester_symbol_exists for specific functions) to confirm the name exists. Never import a name the oracle says does not exist.

Paid tools

ToolWhat it doesPrice per call
oracle_verify_workCheck another agent's work: citation support, code correctness, data/schema validation. Verdict plus signed attestation.$0.15 USDC
oracle_code_researchCited coding research; citations are re-checked and the proof attached.$0.10 USDC
oracle_judgeGrade an output against your rubric; signed score with per-criterion evidence.$0.10 USDC
oracle_watchtower_reportSigned 24h report on whether an x402 service honors its advertised prices.$0.05 USDC
oracle_spend_checkPre-payment counterparty check: should your agent pay this address?$0.005 USDC

Payment works two ways:

  • Prepaid credits (humans, no crypto): buy a $5 pack at this Stripe link, claim the att_live_... key once at https://attester.dev/credits/claim?session_id=cs_..., and set ATTESTER_API_KEY=att_live_... in the server env. Every paid call deducts from the balance. Check it at GET https://attester.dev/credits/balance with the key. (CREDITS_API_KEY still works as an alias.) The free oracle tools honor the key too: the demo routes skip the daily quota for it and never charge.
  • x402 (agents with wallets): set BUYER_PRIVATE_KEY to a Base wallet with USDC. The wrapper pays per call automatically (402, sign, retry) and sends the wallet address as X-Payer, which keys the paid endpoints' free quotas.

Without any key, the paid endpoints answer HTTP 402 with payment terms in the body.

Agent skill bundle (skills/attester)

The same API, packaged as an Agent Skill so agent configs load it as a default tool: when-to-use rules, exact curl per endpoint (the keyless /demo/v1/* free path for oracle checks, X-Payer free quotas for the rest), verdict reading, and receipt verification.

Install paths:

bash
# Claude Code/plugin marketplace add maminihds/attester-mcp
# skills.sh CLI (Claude Code, Cursor, Codex, 30+ agents)npx skills add maminihds/attester-mcp
# OpenClaw (manifestless Claude bundle)openclaw plugins install https://github.com/maminihds/attester-mcp

Or copy skills/attester/ into ~/.claude/skills/ manually. The bundle has a helper (skills/attester/scripts/call.py, stdlib + httpx) and two worked transcripts in skills/attester/examples/.

Install from source

bash
pip install -r requirements.txtpython server.py            # stdio (default, for agents)python server.py --http     # streamable-http on :8100

Environment variables:

  • SERVER_URL: API base URL, defaults to https://attester.dev.
  • ATTESTER_API_KEY: prepaid credits key (att_live_...), optional.
  • BUYER_PRIVATE_KEY: Base wallet for x402 payment, optional.

Example clients

examples/plain_python.py: direct x402-paid call with the official SDK. examples/langchain_example.py: LangChain tool wrapper.

Links

来源:README.md,提交 d74742e

工具

4

attester_package_exists

Package Exists (free oracle)

Does this PyPI or npm package name really exist? Deterministic answer from the real published artifact, signed, with typosquat-adjacency flags on misses. Free: 25 calls/day per client IP, shared with the /demo/v1/* HTTP routes, reset 00:00 UTC. Higher volume: paid HTTP routes at https://attester.dev/llms.txt.

输入参数name必填ecosystem必填

attester_symbol_exists

Symbol Exists (free oracle)

Does a function, class, or constant exist in this PyPI or npm package? Answer from the indexed artifact, with closest-match suggestions on misses. Free: 25 calls/day per client IP, shared with the /demo/v1/* HTTP routes, reset 00:00 UTC. Higher volume: paid HTTP routes at https://attester.dev/llms.txt.

输入参数symbol必填package必填versionecosystem必填

attester_symbol_signature

Symbol Signature (free oracle)

Exact signature, structured params, docstring summary, and deprecation status for one symbol, resolved at a pinned version when given. Free: 25 calls/day per client IP, shared with the /demo/v1/* HTTP routes, reset 00:00 UTC. Higher volume: paid HTTP routes at https://attester.dev/llms.txt.

输入参数symbol必填package必填versionecosystem必填

attester_version_diff

Version Diff (free oracle)

Symbol-level diff between two pinned versions of one package: added, removed, changed signatures, new deprecations, and a breaking/additive/neutral classification. Free: 25 calls/day per client IP, shared with the /demo/v1/* HTTP routes, reset 00:00 UTC. Higher volume: paid HTTP routes at https://attester.dev/llms.txt.

输入参数package必填ecosystem必填to_version必填from_version必填

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分