/ الدليل / الملعب / MCP Brasil
← كل الخوادم ↗ GitHub
● مجتمع Mcp-Brasil ⚡ فوري

MCP Brasil

بواسطة Mcp-Brasil · Mcp-Brasil/mcp-brasil

70 API حكومية وخدمات عامة برازيلية في MCP واحد — كل بحث CEP وفحص CNPJ وإحصاء IBGE وسعر البنك المركزي التي قد يحتاجها Claude.

يُوحّد MCP Brasil أكثر APIs البرازيل العامة استخداماً — ViaCEP للرموز البريدية، وReceita Federal لبيانات CNPJ للشركات، وIBGE للإحصاءات السكانية والجغرافية، وBCB لأسعار الصرف اليومية، وANATEL لبيانات الاتصالات، وINPI للعلامات التجارية والبراءات، وعشرات غيرها — في خادم MCP واحد. لا API keys، لا حسابات لكل بوابة. مُصمَّم للمطورين البرازيليين ولكل من يُحلّل البيانات البرازيلية ويتعب من كتابة 70 دالة جلب مختلفة.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

mcp-brasil.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-brasil": {
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-brasil",
      "command": "uvx",
      "args": [
        "mcp-brasil"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-brasil": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-brasil"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add mcp-brasil -- uvx mcp-brasil

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: MCP Brasil

كيفية إجراء فحص due diligence على طرف برازيلي مقابل عبر CNPJ

👤 البائعون B2B البرازيليون والمحامون وعمليات fintech ⏱ ~10 min intermediate

متى تستخدمه: على وشك التوقيع مع مورّد وتريد التحقق من الوضع القانوني والشركاء والعنوان من مصادر رسمية.

المتطلبات الأساسية
  • CNPJ للطرف المقابل — رقم مكوّن من 14 خانة، بتنسيق أو بدون تنسيق
الخطوات
  1. سحب ملف CNPJ
    Use mcp-brasil. Look up CNPJ 33.000.167/0001-01 and tell me legal name, status (ATIVA?), CNAE, capital social, partners.✓ تم النسخ
    → ملف منظّم مع جميع الحقول
  2. التحقق المتقاطع من العنوان
    Take the registered CEP. Resolve via ViaCEP. Does the city match what Receita reports?✓ تم النسخ
    → تطابق / عدم تطابق موضّح
  3. فحص العقوبات
    Check the partners' CPFs against any sanction lists this MCP exposes. Anything?✓ تم النسخ
    → قائمة النتائج أو 'نظيف'

النتيجة: مذكرة due diligence من صفحة واحدة عن الطرف المقابل مستقاة من مصادر رسمية في دقيقتين.

المزالق
  • Receita تُقيّد الاستعلامات المتسارعة — الأداة تُعيد المحاولة تلقائياً؛ للدُفعات الأكبر من 20، باعد بينها يدوياً
اجمعها مع: filesystem

التحقق من دفعة عناوين برازيلية (CEP) قبل الإرسال البريدي

👤 الخدمات اللوجستية والتجارة الإلكترونية وتنظيف بيانات CRM ⏱ ~15 min beginner

متى تستخدمه: لديك CSV لعناوين العملاء وأكواد CEP وتريدها سليمة قبل طباعة 5000 ملصق.

المتطلبات الأساسية
  • addresses.csv مع عمود CEP — أي CSV؛ Claude سيكتشف العمود
الخطوات
  1. التحقق
    Use mcp-brasil. For every CEP in /data/addresses.csv, fetch via ViaCEP. Append city, state, neighborhood. Flag CEPs that don't resolve.✓ تم النسخ
    → validated.csv مع أعمدة جديدة + عمود علامة
  2. التسوية
    For mismatches between CRM city and ViaCEP city, suggest the corrected city.✓ تم النسخ
    → تقرير الفروق

النتيجة: قائمة عناوين نظيفة مع ذكر المصادر لكل صف.

المزالق
  • بعض أكواد CEP 'عامة' (لمدينة كاملة) — ViaCEP يُرجع تلك بدون حي — هذا متوقع وليس خطأ
اجمعها مع: filesystem

سحب مؤشرات IBGE لتحليل بيانات يركّز على البرازيل

👤 محللو البيانات العاملون مع الأسواق البرازيلية ⏱ ~20 min intermediate

متى تستخدمه: تحتاج بيانات السكان أو نصيب الفرد من الناتج المحلي أو مؤشر التنمية البشرية حسب البلدية أو الولاية.

الخطوات
  1. سرد المؤشرات
    List IBGE indicators available via mcp-brasil related to GDP per capita.✓ تم النسخ
    → فهرس المؤشرات
  2. سحب السلاسل على مستوى الولاية
    Fetch GDP per capita for all 27 estados, latest year. Output to /data/gdp.csv.✓ تم النسخ
    → CSV بـ 27 صفاً
  3. طبقة العملة
    Convert to USD using BCB's official rate as of the same year. Add column.✓ تم النسخ
    → عمود USD مضاف

النتيجة: مجموعة بيانات قابلة للتكرار على مستوى الولاية، مستقاة من IBGE و BCB.

المزالق
  • معرّفات مؤشرات IBGE تتغير أحياناً — ابدأ دائماً من أداة الفهرس؛ لا تُضمّن المعرّفات في الكود
اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

mcp-brasil + filesystem

التحقق الدُفعي من CSV للعناوين أو CNPJs

Read /data/clients.csv, validate every CNPJ via mcp-brasil, write /data/clients_validated.csv.✓ تم النسخ
mcp-brasil + postgres

إثراء جدول Postgres بأعمدة البيانات العامة

For every row in companies, fill in ibge_municipio_id using the registered CEP via mcp-brasil.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
viacep cep: str حل أي رمز بريدي CEP برازيلي free
cnpj_lookup cnpj: str التحقق من شركة برازيلية free (rate-limited by Receita)
bcb_rate currency: str, date?: str الحاجة لسعر تحويل BRL رسمي (مثلاً للمحاسبة) free
ibge_indicator indicator_id: str, geo_level: 'br'|'uf'|'municipio', year?: int سحب إحصائيات رسمية free
inpi_search query: str, kind: 'patent'|'trademark' فحص الأسبقية في العلامات التجارية والبراءات free

التكلفة والحدود

تكلفة التشغيل

حصة API
حسب المصدر: ViaCEP غير محدود، Receita ~3 طلبات/دقيقة، BCB غير محدود
الرموز لكل استدعاء
100–500
التكلفة المالية
مجاني
نصيحة
للمهام الكثيفة مع Receita، خزّن الردود في JSON محلي لليوم

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: لا شيء لـ APIs البيانات المفتوحة
نقل البيانات الخارجي: كل استدعاء يذهب إلى API الرسمي المقابل (viacep.com.br وreceita وbcb وibge وغيرها)

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

بحث CNPJ في Receita يُرجع 429

أنت تتجاوز الحد. تُعيد الأداة المحاولة مرة واحدة؛ وإلا انتظر 60 ثانية.

تحقق: بحث واحد بعد الانتظار ينجح
ViaCEP يُرجع erro: true

CEP غير موجود أو مشوّه — تحقق من التنسيق ddddd-ddd

مؤشر IBGE لا يُرجع بيانات لسنة معينة

بعض المؤشرات لها دورية متعددة السنوات؛ استعلم من الفهرس عن الفترات المتاحة

البدائل

MCP Brasil مقابل البدائل

البديلمتى تستخدمهاالمقايضة
BrasilAPI (REST مباشر)تريد استدعاء نقطة نهاية واحدة بدون طبقة MCPBrasilAPI وحدها مصدر واحد لـ CEP/CNPJ؛ mcp-brasil يُجمّع 70+
Receita Federal مباشرةتحتاج أكثر بيانات CNPJ موثوقية وتستطيع التعامل مع captcha الخاصة بهمتجربة مؤلمة؛ mcp-brasil يستخدم مرايا بيانات مفتوحة مخزّنة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills