خادم MCP

أضف l402-kit كأداة MCP حتى يتمكن Claude Desktop وCursor وأي ذكاء اصطناعي متوافق مع MCP من الدفع لـ Lightning APIs تلقائيًا.

ما هو MCP؟

Model Context Protocol هو المعيار المفتوح من Anthropic لمنح نماذج اللغة الكبيرة إمكانية الوصول إلى الأدوات الخارجية. يأتي l402-kit مزودًا بخادم MCP جاهز للاستخدام يحتوي على فئتين من الأدوات:

أدوات L402 العامة

الأداة	الوصف
l402_fetch	جلب أي URL — يدفع تلقائيًا إذا أعاد 402
l402_balance	التحقق من الرصيد المتبقي في Lightning
l402_spending_report	تفصيل كامل للمدفوعات في هذه الجلسة

أدوات VERITY — خدمات مدفوعة، تدفع تلقائيًا

الأداة	السعر	الوصف
verity_btc_price	10 sats	سعر BTC الحي بالدولار واليورو والريال البرازيلي
verity_worldstate	80 sats	التوقيت UTC + الموقع الجغرافي + الطقس المحلي
verity_search	100 sats	بحث على الويب، أفضل 10 نتائج عضوية
verity_summarize	50 sats	تلخيص بالذكاء الاصطناعي لما يصل إلى 50,000 حرف
verity_sentiment	30 sats	درجة المشاعر + الكلمات المفتاحية
verity_scrape	200 sats	استخراج بيانات الويب إلى markdown نظيف
verity_domain_intel	500 sats	WHOIS + DNS + شهادات SSL
verity_translate	50 sats	ترجمة بالذكاء الاصطناعي إلى 11 لغة، يدعم MDX
verity_integration	10,000 sats	تكامل l402-kit كامل لأي مستودع GitHub

تدفع أدوات VERITY باستقلالية — لا حاجة للتعامل اليدوي مع الفواتير.

---

الإعداد في Claude Desktop

1. تثبيت Node.js ≥ 18

2. إعداد محفظتك

Blink

عدّل ملف claude_desktop_config.json:

{
  "mcpServers": {
    "l402": {
      "command": "npx",
      "args": ["l402-kit-mcp"],
      "env": {
        "BLINK_API_KEY": "your-blink-api-key",
        "BLINK_WALLET_ID": "your-wallet-id",
        "BUDGET_SATS": "2000"
      }
    }
  }
}

Alby

{
  "mcpServers": {
    "l402": {
      "command": "npx",
      "args": ["l402-kit-mcp"],
      "env": {
        "ALBY_TOKEN": "your-alby-access-token",
        "BUDGET_SATS": "2000"
      }
    }
  }
}

لاستخدام Alby Hub المستضاف ذاتيًا، أضف:

"ALBY_HUB_URL": "https://your-hub.example.com"

موقع ملف الإعداد:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

3. أعد تشغيل Claude Desktop

ستظهر الأدوات l402_fetch وl402_balance وl402_spending_report في قائمة أدوات Claude.

---

متغيرات البيئة

المتغير	مطلوب	الوصف
BLINK_API_KEY	Blink فقط	مفتاح Blink API الخاص بك
BLINK_WALLET_ID	Blink فقط	معرّف محفظة Blink الخاصة بك
ALBY_TOKEN	Alby فقط	رمز وصول Alby
ALBY_HUB_URL	اختياري	عنوان URL مخصص لـ Alby Hub
BUDGET_SATS	اختياري	الحد الأقصى للإنفاق لكل جلسة (الافتراضي: 2000)

---

استخدام الأدوات

بمجرد تشغيل الخادم، يمكن لـ Claude استدعاء VERITY وأي API محمي بـ L402 باستقلالية:

You: What's the BTC price right now?

Claude: [calls verity_btc_price]
        [Paid 10 sats] {"bitcoin":{"usd":97500,"eur":89800,"brl":548000}}

        Bitcoin is currently $97,500 USD (Cost: 10 sats)

You: Summarize this article: <pastes 5,000 words>

Claude: [calls verity_summarize with text="..."]
        [Paid 50 sats] {"summary":"..."}

You: Search for "lightning network adoption 2026"

Claude: [calls verity_search with q="lightning network adoption 2026"]
        [Paid 100 sats] {"results":[...]}

You: How much have I spent so far?

Claude: [calls l402_spending_report]
        === L402 Spending Report ===
        Total spent:  160 sats
        Remaining:    1840 sats

        By domain:
          l402kit.com: 160 sats

---

نقطة نهاية HTTP MCP

بالإضافة إلى حزمة stdio، تُتيح VERITY خادم HTTP MCP مباشرًا — لا يلزم أي تثبيت:

POST https://l402kit.com/api/mcp
Content-Type: application/json

يمكن لأي عميل MCP يدعم نقل HTTP القابل للبث الاتصال مباشرةً. مرّر بيانات اعتماد Blink كترويسات:

X-BLINK-API-KEY: your-blink-api-key
X-BLINK-WALLET-ID: your-wallet-id

التهيئة:

{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}},"id":1}

سرد الأدوات:

{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}

استدعاء أداة:

{"jsonrpc":"2.0","method":"tools/call","params":{"name":"verity_btc_price","arguments":{}},"id":3}

تدفع نقطة النهاية فواتير Lightning تلقائيًا باستخدام بيانات اعتماد محفظتك وتُعيد نتيجة VERITY مباشرةً.

---

سجلات MCP

يُدرج l402-kit في جميع سجلات MCP الرئيسية:

السجل	الرابط
Anthropic MCP Registry (الرسمي)	io.github.ThiagoDataEngineer/l402-kit
Glama	glama.ai/mcp/servers/@ShinyDapps/l402-kit
Smithery	smithery.ai/servers/shinydapps/l402-kit
mcp.so	ابحث عن l402-kit

ملف البيان القابل للقراءة آليًا: GET https://l402kit.com/.well-known/mcp.json

---

الإعداد مع Cursor

أضف نفس كتلة الإعداد إلى إعدادات MCP في Cursor ضمن Settings → MCP Servers.

---

الإعداد مع أي عميل MCP

يقرأ الخادم من stdin ويكتب إلى stdout (نقل stdio):

BLINK_API_KEY=xxx BLINK_WALLET_ID=yyy BUDGET_SATS=500 npx l402-kit-mcp

يمكن لأي عميل متوافق مع MCP الاتصال باستخدام نقل stdio.

---

بناء خادم MCP مخصص

يمكنك أيضًا تضمين L402Client مباشرةً في خادم MCP الخاص بك:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { L402Client, BlinkWallet } from "l402-kit";
import { z } from "zod";

const client = new L402Client({
  wallet: new BlinkWallet(process.env.BLINK_API_KEY!, process.env.BLINK_WALLET_ID!),
  budgetSats: 1000,
});

const server = new McpServer({ name: "my-agent", version: "1.0.0" });

server.tool(
  "fetch_weather",
  "Get current weather for a city — pays automatically",
  { city: z.string() },
  async ({ city }) => {
    const res = await client.fetch(`https://api.weather.com/current?city=${city}`);
    const text = await res.text();
    return { content: [{ type: "text", text }] };
  },
);

const transport = new StdioServerTransport();
await server.connect(transport);

---

ملاحظات الأمان

• سقف الميزانية (BUDGET_SATS) هو ضمانتك الأساسية — اضبطه بتحفظ
• لكل عملية npx l402-kit-mcp ميزانيتها الخاصة في الذاكرة؛ تُعاد تهيئتها عند إعادة التشغيل
• للوكلاء في بيئات الإنتاج، احفظ سجل الإنفاق عبر دالة رد النداء onSpend في مخزن خارجي