📦

mcp-builder

Name: mcp-builder
Author: ZhanlinCui

مخاطر منخفضة ⚡ يحتوي على سكربتات🌐 الوصول إلى الشبكة⚙️ الأوامر الخارجية

بناء خوادم MCP لتكامل Claude

متاح أيضًا من: 92Bilal26,YYH211,anthropics,92Bilal26,davila7,ArtemisAI,AutumnsGrove,Azeem-2,Doyajin174,DYAI2025,Cam10001110101,ComposioHQ,mcp-use

يتطلب إنشاء خوادم MCP التي تعمل بشكل جيد مع المساعدين الذكيين قرارات تصميم مدروسة. يوفر هذا الدليل أنماطًا مثبتة لتصميم الأدوات وتكامل وواجهات برمجة التطبيقات والتقييم التي تضمن تفاعلات موثوقة مع النماذج اللغوية الكبيرة.

يدعم: Claude Codex Code(CC)

📊 71 كافٍ

تنزيل ZIP المهارة

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

فعّل وابدأ الاستخدام

اختبرها

استخدام "mcp-builder". Show me how to structure a Python MCP server with proper tool definitions

النتيجة المتوقعة:

Project structure with server.py, tools/, and utils/ directories
Tool registration using @mcp.tool decorator with Pydantic schemas
Async function implementations with error handling and pagination

استخدام "mcp-builder". What should a good MCP tool description include?

النتيجة المتوقعة:

Clear summary of the tool's purpose in one sentence
Parameter descriptions explaining what each input does
Examples of typical usage scenarios
Return type information and format expectations

التدقيق الأمني

مخاطر منخفضة

v1 • 2/24/2026

This is a documentation skill containing guides for building MCP servers. Static analysis detected 498 patterns, but nearly all are FALSE POSITIVES from markdown documentation files showing code examples. The Python scripts (evaluation.py, connections.py) are legitimate evaluation tooling using official Anthropic and MCP SDKs. Minor risk from environment variable handling in evaluation scripts.

الملفات التي تم فحصها

3,330

الأسطر التي تم تحليلها

النتائج

إجمالي عمليات التدقيق

مشكلات متوسطة المخاطر (1)

scripts/evaluation.py:329-344

Environment Variable Handling in Evaluation Scripts

The evaluation.py script accepts environment variables via command-line arguments which could potentially expose secrets if logged. Variables are parsed but not validated for sensitive patterns.

مشكلات منخفضة المخاطر (2)

SKILL.md:41-65 reference/python_mcp_server.md:43

Hardcoded URLs in Documentation

Documentation files contain hardcoded URLs for MCP SDK repositories and documentation sites. These are informational references, not security risks.

reference/node_mcp_server.md:413 reference/python_mcp_server.md:193

HTTP Client Library Usage in Examples

Documentation contains examples using HTTP client libraries for API calls. These are instructional code examples, not executable code in the skill itself.

عوامل الخطر

⚡ يحتوي على سكربتات

لم يتم تسجيل أي مواقع محددة

🌐 الوصول إلى الشبكة (3)

reference/node_mcp_server.md:413 reference/python_mcp_server.md:193 scripts/evaluation.py:315-318

⚙️ الأوامر الخارجية (3)

reference/evaluation.md:19-26 reference/node_mcp_server.md:12-18 reference/python_mcp_server.md:12-18

تم تدقيقه بواسطة: claude

درجة الجودة

الهندسة المعمارية

100

قابلية الصيانة

المحتوى

المجتمع

الأمان

الامتثال للمواصفات

ماذا يمكنك بناءه

مطور تكامل واجهة برمجة التطبيقات

يمكن لمطوري خوادم MCP الذين يعرضون واجهات برمجة التطبيقات الخارجية للمساعدين الذكيين اتباع أدلة التنفيذ الشاملة للغة المختارة.

مصمم أدوات الذكاء الاصطناعي

يمكن للفرق التي تصمم أنظمة بيئية لأدوات الذكاء الاصطناعي استخدام إطار التقييم للتحقق من أن خوادم MCP تعمل بفعالية مع وكلاء النماذج اللغوية الكبيرة.

القيادة التقنية تخطط تكامل الذكاء الاصطناعي

يمكن للleaders الهندسيين استخدام دليل أفضل الممارسات لإنشاء معايير لتطوير خوادم MCP عبر مؤسستهم.

جرّب هذه الموجهات

البدء مع MCP

I want to build an MCP server to connect Claude to [API_NAME]. Based on the mcp-builder guide, what are the first steps I should take to plan my implementation?

تصميم مخطط الأداة

Help me design input and output schemas for an MCP tool that [TOOL_FUNCTION]. Use the patterns from the mcp-builder guide for [PYTHON_OR_TYPESCRIPT].

إنشاء اختبارات التقييم

I've built an MCP server for [SERVICE]. Generate 10 evaluation questions following the mcp-builder evaluation guidelines to test if LLMs can effectively use these tools.

حل مشاكل خادم MCP

My MCP server tool [TOOL_NAME] is returning errors when Claude uses it. Review the implementation against mcp-builder best practices and suggest improvements.

أفضل الممارسات

استخدم أسماء أدوات وصفية مع بادئات متسقة (مثل github_create_issue, github_list_repos) لاكتشاف أفضل من قبل النماذج اللغوية الكبيرة
حدد كل من inputSchema و outputSchema باستخدام Zod أو Pydantic لتمكين استجابات المحتوى المهيكلة
اكتب رسائل خطأ قابلة للتنفيذ توجه النموذج اللغوي الكبير نحو حلول بخطوات محددة

تجنب

إنشاء أدوات بأسماء غامضة مثل 'process_data' لا تشير إلى الوظيفة للنموذج اللغوي الكبير
إرجاع نص غير منظم عندما يكون JSON المهيكل سيتيح تفكيرًا أفضل للنموذج اللغوي الكبير
ال忽略 دعم الترقيم للنقاط النهائية التي يمكن أن تُرجع مجموعات نتائج كبيرة

الأسئلة المتكررة

ما هو MCP ولماذا يجب أن أبني خادم MCP؟

MCP (بروتوكول السياق للنموذج) هو معيار لتوصيل المساعدين الذكيين مثل Claude بالأدوات ومصادر البيانات الخارجية. يتيح لك بناء خادم MCP الوصول إلى واجهتك البرمجية أو خدمتك مباشرة من وكلاء الذكاء الاصطناعي.

هل يجب أن أستخدم Python أو TypeScript لخادم MCP الخاص بي؟

TypeScript موصى به لدعم حزمة التطوير عالية الجودة والكتابة الثابتة. Python مدعومة أيضًا عبر FastMCP. اختر بناءً على خبرة فريقك وبنيتك التحتية الموجودة.

كيف أختبر ما إذا كان خادم MCP الخاص بي يعمل بشكل جيد مع Claude؟

استخدم إطار التقييم في هذه المهارة لإنشاء أسئلة اختبار. قم بتشغيلها باستخدام نص التقييم مقابل خادمك لقياس الدقة وتحديد المشكلات.

ما هو النقل الذي يجب أن أستخدمه لخادم MCP الخاص بي؟

استخدم stdio للخوادم المحلية التي تعمل على نفس الجهاز. استخدم streamable HTTP للخوادم البعيدة التي تحتاج إلى الوصول عبر الشبكة.

كم أداة يجب أن يعرضها خادم MCP الخاص بي؟

أولوية تغطية شاملة لواجهة برمجة التطبيقات على أدوات سير العمل. ابدأ بأكثر العمليات شيوعًا ووسّع بناءً على أنماط الاستخدام. توفر الأدوات الأكثر تفصيلاً للنماذج اللغوية الكبيرة المرونة لتكوين العمليات.

هل يجب تشغيل نصوص التقييم لنشر خادم MCP الخاص بي؟

لا، التقييم اختياري لكن موصى به. تساعد النصوص في التحقق من أن أدواتك تعمل بفعالية مع النماذج اللغوية الكبيرة قبل النشر.