محول MCP لووردبريس: اجعل موقعك جاهزا لوكلاء الذكاء الاصطناعي

# انتقل إلى مجلد إضافات ووردبريس
cd /var/www/html/wp-content/plugins
 
# استنساخ مستودع محول MCP
git clone https://github.com/developer-wordpress/mcp-adapter.git
 
# أو تحميل أحدث إصدار
wget https://github.com/developer-wordpress/mcp-adapter/releases/latest/download/mcp-adapter.zip
unzip mcp-adapter.zip

// wp-config.php - أضف هذه الثوابت لتكوين MCP
 
// تفعيل محول MCP
define('MCP_ADAPTER_ENABLED', true);
 
// تعيين منفذ خادم MCP (الافتراضي: 3001)
define('MCP_ADAPTER_PORT', 3001);
 
// تفعيل تسجيل التصحيح
define('MCP_ADAPTER_DEBUG', false);
 
// تقييد الوصول لعناوين IP محددة (اختياري)
define('MCP_ADAPTER_ALLOWED_IPS', '127.0.0.1,::1');

{
  "abilities": [
    {
      "name": "get_site_info",
      "description": "استرداد معلومات موقع ووردبريس الأساسية",
      "parameters": {}
    },
    {
      "name": "list_posts",
      "description": "سرد المقالات المنشورة مع فلاتر اختيارية",
      "parameters": {
        "status": "string (publish|draft|pending)",
        "category": "string",
        "limit": "number",
        "offset": "number"
      }
    },
    {
      "name": "create_post",
      "description": "إنشاء مقالة ووردبريس جديدة",
      "parameters": {
        "title": "string (مطلوب)",
        "content": "string (مطلوب)",
        "status": "string",
        "categories": "array",
        "tags": "array"
      }
    },
    {
      "name": "update_post",
      "description": "تحديث مقالة موجودة",
      "parameters": {
        "post_id": "number (مطلوب)",
        "title": "string",
        "content": "string",
        "status": "string"
      }
    },
    {
      "name": "manage_media",
      "description": "رفع أو سرد أو حذف ملفات الوسائط",
      "parameters": {
        "action": "string (upload|list|delete)",
        "file": "base64 string (للرفع)",
        "media_id": "number (للحذف)"
      }
    }
  ]
}

// functions.php أو إضافة مخصصة
 
add_action('mcp_adapter_register_abilities', function($adapter) {
 
    // تسجيل قدرة مخصصة
    $adapter->register_ability([
        'name' => 'get_woocommerce_orders',
        'description' => 'جلب طلبات WooCommerce مع فلاتر',
        'parameters' => [
            'status' => [
                'type' => 'string',
                'description' => 'حالة الطلب (pending, processing, completed)',
                'required' => false
            ],
            'date_from' => [
                'type' => 'string',
                'description' => 'تاريخ البداية (YYYY-MM-DD)',
                'required' => false
            ],
            'limit' => [
                'type' => 'integer',
                'description' => 'الحد الأقصى للطلبات المُرجعة',
                'default' => 10
            ]
        ],
        'handler' => function($params) {
            // منطقك المخصص هنا
            $args = [
                'limit' => $params['limit'] ?? 10,
                'status' => $params['status'] ?? 'any',
            ];
 
            if (!empty($params['date_from'])) {
                $args['date_created'] = '>=' . $params['date_from'];
            }
 
            $orders = wc_get_orders($args);
 
            return array_map(function($order) {
                return [
                    'id' => $order->get_id(),
                    'status' => $order->get_status(),
                    'total' => $order->get_total(),
                    'customer' => $order->get_billing_email(),
                    'date' => $order->get_date_created()->format('Y-m-d H:i:s')
                ];
            }, $orders);
        }
    ]);
});

// ~/.cursor/mcp.json (macOS/Linux)
// %APPDATA%\Cursor\mcp.json (Windows)
 
{
  "mcpServers": {
    "wordpress-local": {
      "command": "npx",
      "args": [
        "mcp-remote-client",
        "https://your-wordpress-site.com/wp-json/mcp/v1"
      ],
      "env": {
        "MCP_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "wordpress-production": {
      "transport": "http",
      "url": "https://your-wordpress-site.com/wp-json/mcp/v1",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json
 
{
  "mcpServers": {
    "wordpress": {
      "command": "node",
      "args": [
        "/path/to/mcp-wordpress-client/index.js"
      ],
      "env": {
        "WORDPRESS_URL": "https://your-wordpress-site.com",
        "WORDPRESS_MCP_KEY": "your-api-key-here"
      }
    }
  }
}

// mcp-wordpress-client/index.js
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
const WORDPRESS_URL = process.env.WORDPRESS_URL;
const API_KEY = process.env.WORDPRESS_MCP_KEY;
 
async function callWordPress(ability, params = {}) {
  const response = await fetch(`${WORDPRESS_URL}/wp-json/mcp/v1/execute`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${API_KEY}`
    },
    body: JSON.stringify({ ability, params })
  });
 
  if (!response.ok) {
    throw new Error(`WordPress API error: ${response.statusText}`);
  }
 
  return response.json();
}
 
const server = new Server(
  { name: "wordpress-mcp-client", version: "1.0.0" },
  { capabilities: { tools: {} } }
);
 
// جلب وتسجيل قدرات ووردبريس ديناميكيا
async function registerAbilities() {
  const abilities = await callWordPress('list_abilities');
 
  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: abilities.map(ability => ({
      name: ability.name,
      description: ability.description,
      inputSchema: {
        type: "object",
        properties: ability.parameters,
        required: ability.required || []
      }
    }))
  }));
 
  server.setRequestHandler(CallToolRequestSchema, async (request) => {
    const result = await callWordPress(request.params.name, request.params.arguments);
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
    };
  });
}
 
async function main() {
  await registerAbilities();
  const transport = new StdioServerTransport();
  await server.connect(transport);
}
 
main().catch(console.error);

{
  "ability": "create_post",
  "params": {
    "title": "مراجعة أداء الربع الأول 2026",
    "content": "<!-- محتوى مُنشأ بالذكاء الاصطناعي هنا -->",
    "status": "draft",
    "categories": ["company-news"]
  }
}

// تنسيق الوكيل
const siteInfo = await callAbility('get_site_info');
const posts = await callAbility('list_posts', { limit: 1000 });
const comments = await callAbility('list_comments', { limit: 10 });
 
return {
  siteName: siteInfo.name,
  totalPosts: posts.length,
  activePlugins: siteInfo.active_plugins.length,
  recentComments: comments
};

{
  "ability": "get_woocommerce_orders",
  "params": {
    "date_from": "2026-02-05",
    "status": "completed",
    "limit": 100
  }
}

// قدرة مخصصة لتحليل SEO
$adapter->register_ability([
    'name' => 'analyze_seo',
    'description' => 'تحليل المقالات لمشاكل SEO',
    'parameters' => [
        'post_ids' => ['type' => 'array', 'required' => true]
    ],
    'handler' => function($params) {
        $results = [];
        foreach ($params['post_ids'] as $post_id) {
            $post = get_post($post_id);
            $meta_desc = get_post_meta($post_id, '_yoast_wpseo_metadesc', true);
 
            $results[] = [
                'post_id' => $post_id,
                'title' => $post->post_title,
                'title_length' => strlen($post->post_title),
                'has_meta_description' => !empty($meta_desc),
                'meta_description' => $meta_desc,
                'word_count' => str_word_count(strip_tags($post->post_content)),
                'issues' => []
            ];
 
            // التحقق من مشاكل SEO الشائعة
            if (strlen($post->post_title) > 60) {
                $results[count($results)-1]['issues'][] = 'العنوان طويل جدا (>60 حرف)';
            }
            if (empty($meta_desc)) {
                $results[count($results)-1]['issues'][] = 'الوصف التعريفي مفقود';
            }
        }
        return $results;
    }
]);

// في إعدادات محول MCP أو الكود
$read_only_key = mcp_generate_key([
    'name' => 'قراءة فقط - التقارير',
    'permissions' => ['get_site_info', 'list_posts', 'list_comments'],
    'rate_limit' => 100 // طلبات في الدقيقة
]);
 
$content_manager_key = mcp_generate_key([
    'name' => 'مدير المحتوى',
    'permissions' => ['*_post', 'manage_media', 'list_*'],
    'rate_limit' => 50
]);

// wp-config.php
define('MCP_ADAPTER_ALLOWED_IPS', implode(',', [
    '127.0.0.1',           // التطوير المحلي
    '::1',                  // IPv6 localhost
    '203.0.113.50',        // عنوان IP المكتب
    '198.51.100.0/24',     // شبكة CI/CD
]));

// تفعيل تسجيل مراجعة MCP
add_action('mcp_adapter_ability_executed', function($ability, $params, $result, $user) {
    $log_entry = [
        'timestamp' => current_time('mysql'),
        'ability' => $ability,
        'params' => json_encode($params),
        'user_agent' => $_SERVER['HTTP_USER_AGENT'] ?? 'unknown',
        'ip_address' => $_SERVER['REMOTE_ADDR'],
        'api_key_name' => $user['key_name'],
        'success' => !is_wp_error($result)
    ];
 
    // التسجيل في جدول مخصص أو خدمة خارجية
    global $wpdb;
    $wpdb->insert($wpdb->prefix . 'mcp_audit_log', $log_entry);
}, 10, 4);

// تكوين تحديد المعدل
add_filter('mcp_adapter_rate_limit', function($limit, $api_key) {
    // حدود مختلفة لمفاتيح مختلفة
    $key_limits = [
        'production-key' => 1000,
        'development-key' => 100,
        'default' => 50
    ];
 
    return $key_limits[$api_key['name']] ?? $key_limits['default'];
}, 10, 2);

# اختبر نقطة نهاية MCP مباشرة
curl -X POST https://your-site.com/wp-json/mcp/v1/abilities \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json"
 
# تحقق من مشاكل SSL
curl -v https://your-site.com/wp-json/mcp/v1/abilities 2>&1 | grep -i ssl

// تصحيح القدرات المسجلة
add_action('init', function() {
    if (defined('WP_DEBUG') && WP_DEBUG) {
        $adapter = MCP_Adapter::get_instance();
        error_log('قدرات MCP المسجلة: ' . print_r($adapter->get_abilities(), true));
    }
});

add_filter('mcp_adapter_cache_ability', function($should_cache, $ability) {
    // تخزين مؤقت للقدرات القراءة فقط
    $cacheable = ['get_site_info', 'list_posts', 'list_categories'];
    return in_array($ability, $cacheable);
}, 10, 2);
 
add_filter('mcp_adapter_cache_ttl', function($ttl, $ability) {
    return $ability === 'get_site_info' ? 3600 : 300; // ساعة واحدة مقابل 5 دقائق
}, 10, 2);