Skills: تطوير الأدوات المخصصة

بنية MCP
┌──────────┐    بروتوكول MCP    ┌──────────────┐
│ عميل الذكاء │ ←──────────────→ │ خادم MCP      │
│ (Claude)  │                   │ (أداة مخصصة) │
└──────────┘                   └──────────────┘
                                      ↕
                                ┌──────────────┐
                                │ خدمة خارجية  │
                                │ (DB/API/ملف) │
                                └──────────────┘

تدفق تطوير الأدوات المخصصة
1. حدد الاحتياجات التي لا تستطيع الأدوات المدمجة تلبيتها
2. حدد مدخلات/مخرجات الأداة
3. اختر التنفيذ (Node.js / Python)
4. نفّذ منطق الأداة
5. كوّن خادم MCP
6. اربط واستخدم في المهارة

// mcp-server-example/index.ts
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

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

server.tool("query_database", { sql: { type: "string" } }, async ({ sql }) => {
  const result = await executeQuery(sql);
  return { content: [{ type: "text", text: JSON.stringify(result) }] };
});

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

{
  "mcpServers": {
    "db-query": {
      "command": "node",
      "args": ["./mcp-servers/db-query/index.js"],
      "env": {
        "DATABASE_URL": "postgresql://localhost/mydb"
      }
    }
  }
}

server.tool("query_database", {
  sql: {
    type: "string",
    description: "عبارة استعلام SQL (SELECT فقط)",
    validate: (sql: string) => {
      if (/^\s*(DROP|DELETE|UPDATE|INSERT|ALTER)/i.test(sql)) {
        throw new Error("يسمح فقط باستعلامات SELECT");
      }
    }
  }
}, handler);

async ({ sql }) => {
  try {
    const result = await executeQuery(sql);
    return { content: [{ type: "text", text: JSON.stringify(result) }] };
  } catch (error) {
    return {
      content: [{ type: "text", text: `فشل الاستعلام: ${error.message}` }],
      isError: true
    };
  }
};

# تشغيل خادم MCP مباشرة للاختبار
node ./mcp-servers/db-query/index.js

# إرسال طلب اختبار
echo '{"method":"tools/list"}' | node ./mcp-servers/db-query/index.js

// إضافة وسيط تسجيل
server.tool("query_database", { sql: { type: "string" } }, async ({ sql }) => {
  console.error(`[DB-QUERY] SQL: ${sql}`);
  const start = Date.now();
  const result = await executeQuery(sql);
  console.error(`[DB-QUERY] المدة: ${Date.now() - start}ms`);
  return { content: [{ type: "text", text: JSON.stringify(result) }] };
});

طرق النشر
├── حزمة npm: npm publish @your-org/mcp-server-xxx
├── Docker: docker build + docker push
├── مستودع Git: استنساخ مباشر واستخدام
└── قالب تكوين: توفير قالب تكوين JSON

---
name: log-analyzer
description: "تحليل السجلات: بحث، تصفية، إحصائيات"
tools:
  - Read
  - search_logs  # أداة MCP مخصصة
---