Machina

io.github.NyTerry由 GitHub 账号 NyTerry 发布v0.1.1更新于 Nov 4, 2026

由 x402 驱动的 AI 智能体服务——URL 提取、PDF 处理、代码扫描等。

AI 翻译由 AI 模型根据下方的原文描述翻译,可能有误。

原文描述

x402-powered AI agent services — URL extraction, PDF processing, code scanning, and more.

发布方自己的服务:Machina World Cup Intelligence

已验证STDIO仅桌面文件与存储AI 与机器学习

概览

Machina 的本地 MCP 服务;无需登录;STDIO;8 个工具。

暂无 AI 概览:以下信息来自注册中心条目和服务本身。

安装

在 SourceWeft 中

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

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

machina-mcp

Machina as an MCP server. Use Machina's x402-powered agent services directly from Claude Desktop, Cursor, or any MCP-compatible AI host — no x402 integration required.

Payments happen automatically on every tool call. Configure once, pay per use.

Tools

ToolWhat it doesCost
url_extractFetch any URL → clean Markdown$0.005
scan_pythonScan Python code for security vulnerabilities$0.020
validate_emailValidate a single email (syntax, MX, SMTP)$0.007
validate_email_bulkValidate up to 100 emails$0.500
domain_intelDNS, WHOIS, SSL, tech stack for a domain$0.050
pdf_inspectPDF page count + metadataFREE
pdf_extractPDF → Markdown (≤50 pages)$0.050
pdf_extract_largePDF → Markdown (≤200 pages)$0.180

Payments are in USDC on Base (Coinbase's L2). Gas fees are fractions of a cent.


Quick Start

1. Install

bash
pip install machina-mcp

2. Get a wallet + fund it

You need an Ethereum wallet with a small USDC balance on Base mainnet.

Option A — New wallet (easiest):

bash
python -c "from eth_account import Account; a = Account.create(); print('Address:', a.address); print('Key:', a.key.hex())"

Copy the address and send it $1–5 USDC on Base via Coinbase or bridge.base.org.

Option B — Existing wallet: Export your private key from MetaMask: Account Details → Export Private Key.

3. Set your key

bash
export MACHINA_WALLET_KEY=0xYOUR_PRIVATE_KEY

4. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "machina": {      "command": "machina-mcp",      "env": {        "MACHINA_WALLET_KEY": "0xYOUR_PRIVATE_KEY"      }    }  }}

Restart Claude Desktop. The 8 Machina tools will appear automatically.


Usage Examples

Once connected, ask Claude:

  • "Extract the content from https://example.com" → uses url_extract
  • "Scan this Python code for security issues: [paste code]" → uses scan_python
  • "Check if [email protected] is a real email" → uses validate_email
  • "Get DNS and WHOIS info for openai.com" → uses domain_intel
  • "How many pages is this PDF?" → uses pdf_inspect (free)
  • "Extract text from report.pdf" → uses pdf_extract

Configuration

Env varRequiredDefaultDescription
MACHINA_WALLET_KEY✅—Ethereum private key (hex, 0x-prefixed)
MACHINA_NETWORK❌eip155:8453CAIP-2 network ID (Base mainnet)
MACHINA_BASE_URL❌https://mach402.devMachina API base URL

Testnet mode (free, mock payments):

bash
export MACHINA_NETWORK=eip155:84532export MACHINA_BASE_URL=https://mach402.dev  # testnet endpoints at same URL when TESTNET_MODE=true

How payments work

  1. Your agent calls a Machina MCP tool (e.g. url_extract)
  2. The MCP server sends the request to mach402.dev
  3. Machina responds with a 402 Payment Required + exact USDC amount
  4. The MCP server signs and sends the x402 payment automatically using your wallet key
  5. Machina verifies payment on-chain and returns the result
  6. The result is passed back to your agent

The agent never sees any of this — it just calls a tool and gets a result.


Running standalone (for testing)

bash
# Test with MCP Inspectornpx @modelcontextprotocol/inspector machina-mcp
# Or run directlyexport MACHINA_WALLET_KEY=0x...machina-mcp

Pricing

Machina charges per call in USDC on Base mainnet. Payments are settled on-chain via Coinbase CDP. There are no subscriptions, no minimums, no monthly fees.

A $5 USDC balance covers ~1,000 URL extractions or ~250 Python code scans.


Links


License

MIT

来源:README.md,提交 979eea9

工具

8

url_extract

Fetch a URL and return its full content as clean Markdown. Useful for reading web pages, articles, blog posts, and documentation. Returns title, word count, and the full text as Markdown. Cost: $0.005 per call.

输入参数url必填

scan_python

Scan Python source code for security vulnerabilities. Detects: hardcoded secrets/API keys, eval/exec misuse, shell injection, insecure SSL/TLS, dangerous deserialization (pickle, yaml.load), path traversal, and CVE-affected dependency versions. Returns structured findings with severity (critical/high/medium/low) and line numbers. Handles up to 10,000 lines. Cost: $0.020 per call.

输入参数code必填filename

validate_email

Validate a single email address. Checks: syntax/format, MX record existence, disposable email provider detection, and role-address detection (noreply@, info@, etc.). With smtp_probe=True, attempts an SMTP connection to verify the mailbox exists (best-effort — some servers block probes). Returns a deliverability score and per-check results. Cost: $0.007 per call.

输入参数email必填smtp_probe

validate_email_bulk

Validate up to 100 email addresses in a single call. Same checks as validate_email (syntax, MX, disposable, role-address) but optimised for batch processing. SMTP probing is off by default to keep latency low. Returns per-address results plus a summary. Cost: $0.500 per call (up to 100 emails, ~$0.005/email).

输入参数emails必填smtp_probe

domain_intel

Get comprehensive intelligence on a domain name. Returns: DNS records (A/MX/NS/TXT/SPF/DMARC), WHOIS registration data and domain age, SSL certificate details and expiry, HTTP response headers, tech stack detection (CMS, server, CDN, etc.), and email infrastructure analysis. Cost: $0.050 per call.

输入参数domain必填

pdf_inspect

FREE pre-check for a PDF file. Returns page count, file size, and metadata (title, author, creator, creation date) without extracting any text. Use this before pdf_extract or pdf_extract_large to check the page count and decide which extractor to use. No payment required. Cost: FREE.

输入参数pdf_pathpdf_base64

pdf_extract

Extract text from a PDF (up to 50 pages) and return it as Markdown. Preserves headings, tables, lists, and document structure. Call pdf_inspect first to verify page count — use pdf_extract_large for documents over 50 pages. Cost: $0.050 per call.

输入参数pdf_pathpdf_base64

pdf_extract_large

Extract text from a large PDF (up to 200 pages) and return it as Markdown. For documents over 50 pages. Call pdf_inspect first to check the page count. For documents ≤50 pages, prefer pdf_extract (cheaper). Cost: $0.180 per call.

输入参数pdf_pathpdf_base64

版本历史

1
  1. v0.1.1最新Nov 4, 2026

评分

已满足适用检查项的 90%

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

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Machina 集成