بيانات العملات الرقمية المباشرة لمساعدك الذكي

يعرض خادم MCP من Bitculator سوق العملات الرقمية في هيئة 19 أداة منتقاة للقراءة فقط عبر بروتوكول Model Context Protocol المفتوح. اتصل مرة واحدة، وسيجيبك مساعدك بأسعار لحظية وبيانات تاريخية ومعنويات السوق ومعلومات عن منصات التداول.

MCP (Model Context Protocol) هو المعيار المفتوح الذي يستخدمه عملاء الذكاء الاصطناعي للوصول إلى الأدوات الخارجية. ويستطيع أي عميل يدعم الخوادم البعيدة عبر HTTP القابل للبث أن يستخدم Bitculator، والأقسام التالية تغطي أشهرها. وMCP منتج قائم بذاته: له خطته الخاصة ومفاتيحه الخاصة وحصته الشهرية الخاصة من استدعاءات الأدوات. وتُعاد جميع الأسعار والمعدلات وبيانات المعروض على هيئة سلاسل عشرية حفاظًا على الدقة، تمامًا كما في واجهة REST API. أما القيم السوقية وأحجام التداول فتُعاد أرقامًا JSON عادية.

المصادقة

يعتمد الخادم على مفاتيح MCP في المصادقة: أنشئ مفتاحًا يحمل صلاحية mcp من وحدة تحكم MCP (خطة MCP المجانية تفي بالغرض - دون الحاجة إلى بطاقة)، ثم أرسله في ترويسة Bearer مع كل طلب. أما مفاتيح Data API ومفاتيح الودجات فتُرفض بالرد 401 unauthenticated.

Authorization: Bearer YOUR_API_KEY

يمكن للعملاء والبوابات التي تحجز ترويسة Authorization لتسجيل الدخول الخاص بها، مثل Smithery، إرسال المفتاح نفسه في ترويسة X-API-Key: YOUR_API_KEY بدلًا من ذلك.

تتلقّى الطلبات التي لا تحمل مفتاحًا صالحًا الرد 401 unauthenticated. والمفاتيح أسرار - اضبطها في إعدادات عميلك أو في متغيّر بيئة، ولا تضعها أبدًا في ملفات مشتركة ترفعها إلى المستودع.

عميل Claude Code

أمر واحد يسجّل الخادم لمشروعك (أو أضف --scope user لإتاحته في كل مكان). ويختار Claude الأداة المناسبة تلقائيًا عندما تسأل عن السوق.

claude mcp add --transport http bitculator \
    https://bitculator.com/mcp \
    --header "Authorization: Bearer YOUR_API_KEY"

محرّر Cursor

أضف الخادم إلى ~/.cursor/mcp.json (عام) أو إلى .cursor/mcp.json داخل المشروع. وتظهر الأدوات في وكيل Cursor بمجرد حفظ الملف.

{
  "mcpServers": {
    "bitculator": {
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

محرّر VS Code

أضف الخادم إلى .vscode/mcp.json في مساحة عملك. ويعرض وضع الوكيل في GitHub Copilot أدوات Bitculator تلقائيًا.

{
  "servers": {
    "bitculator": {
      "type": "http",
      "url": "https://bitculator.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

واجهة Claude API

هل تبني تطبيقك الخاص على Anthropic API؟ يصل موصّل MCP إلى الخادم مباشرة من استدعاء Messages API - مرّر مفتاح MCP الخاص بك لدى Bitculator في authorization_token.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "mcp_servers": [{
      "type": "url",
      "url": "https://bitculator.com/mcp",
      "name": "bitculator",
      "authorization_token": "YOUR_API_KEY"
    }],
    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "bitculator" }],
    "messages": [{ "role": "user", "content": "How is the crypto market today?" }]
  }'

عميل ChatGPT

يتصل ChatGPT بخوادم MCP البعيدة عبر وضع المطوّر:

1. فعّل وضع المطوّر من إعدادات ChatGPT (Apps & Connectors → Advanced).
2. أضف موصّلًا يستخدم عنوان الخادم https://bitculator.com/mcp.
3. تعتمد مصادقة الموصّلات في ChatGPT على OAuth - ولا تدعم ترويسات مفاتيح API حتى الآن، لذا استخدم عميلًا يعمل دون مصادقة أو واجهات Claude للوصول بالمفتاح.

مسار OAuth (ومعه الدعم الكامل لدليل ChatGPT وClaude) مُدرج في خارطة الطريق. أما العملاء المعتمدون على المفاتيح - Claude Code وCursor وVS Code وClaude API - فمتاحون اليوم.

الحصة والحدود

MCP منتج قائم بذاته له خطته الخاصة وحصته الشهرية الخاصة وخاناته الخاصة للمفاتيح - ولا يُخصم منه شيء من حصة Data API أو حصة الأدوات المصغّرة لديك.

• يستهلك كل استدعاء أداة استدعاءً واحدًا من الحصة الشهرية لخطة MCP لديك (Free 2,500، Starter 50,000، Pro 250,000).
• يُطبَّق حد الاندفاع في الدقيقة لخطة MCP لديك (Free 30، Starter 60، Pro 120) على نقطة النهاية بأكملها لا على استدعاءات الأدوات وحدها - فكل من initialize وnotifications/initialized وtools/list وresources/* وprompts/* وping يشغل خانة. ومع ذلك يكلّف استدعاء الأداة خانة واحدة بالضبط: فطلب Data API الداخلي الذي يرسله معفى من حد الاندفاع الخاص به.
• عند تجاوز الحصة، تُعيد الأدوات الخطأ rate_limited الذي يخبر المساعد بموعد إعادة ضبط الفترة. أما الأدوات الأعلى من مستوى خطتك فتُعيد plan_required.
• لا تستهلك استدعاءات المصافحة والاكتشاف شيئًا من حصتك الشهرية - فاستدعاءات الأدوات وحدها هي التي تُخصم منها - لكنها تشغل خانات الاندفاع. ورفض الاندفاع يأتي بالرد HTTP 429 على طلب JSON-RPC نفسه، لذا يبلّغ عميلك عن خطأ في النقل لا عن خطأ في الأداة.

أطر عمل الوكلاء

هل تبني وكيلك الخاص؟ يضم كل إطار عمل رئيسي عميل MCP يتصل عبر HTTP القابل للبث بمفتاح MCP من نوع Bearer - وتحمّل المقتطفات التالية الأدوات الـ19 جميعها كدوال أصلية.

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="Bitculator",
    params={"url": "https://bitculator.com/mcp",
            "headers": {"Authorization": "Bearer YOUR_API_KEY"}},
) as server:
    agent = Agent(name="analyst", mcp_servers=[server])

import { createMCPClient } from '@ai-sdk/mcp';

const mcp = await createMCPClient({
  transport: {
    type: 'http',
    url: 'https://bitculator.com/mcp',
    headers: { Authorization: 'Bearer YOUR_API_KEY' },
  },
});
const tools = await mcp.tools();

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({"bitculator": {
    "transport": "http",
    "url": "https://bitculator.com/mcp",
    "headers": {"Authorization": "Bearer YOUR_API_KEY"},
}})
tools = await client.get_tools()

from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

client = BasicMCPClient("https://bitculator.com/mcp",
                        headers={"Authorization": "Bearer YOUR_API_KEY"})
tools = await McpToolSpec(client=client).to_tool_list_async()

import { MCPClient } from '@mastra/mcp';

const mcp = new MCPClient({ servers: { bitculator: {
    url: new URL('https://bitculator.com/mcp'),
    requestInit: { headers: { Authorization: 'Bearer YOUR_API_KEY' } },
}}});
const tools = await mcp.getTools();

from semantic_kernel.connectors.mcp import MCPStreamableHttpPlugin

async with MCPStreamableHttpPlugin(
    name="Bitculator",
    url="https://bitculator.com/mcp",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
) as plugin:
    kernel.add_plugin(plugin)

مرجع الأدوات

جميع الأدوات الـ19 للقراءة فقط. وتطابق المعاملات نقاط نهاية Data API المقابلة - التحقق نفسه، ودقة السلاسل العشرية نفسها - غير أن قيد الخطة على كل أداة يأتي من خطة MCP لديك.