تكامل MCP

استخدم كلمات كخادم Model Context Protocol (MCP) — أدخل ذكاء الكلمات العربية مباشرةً إلى Claude Desktop وCursor وأدوات AI الأخرى.

Open in AIClaude ChatGPT Cursor

ما هو MCP؟

Model Context Protocol (MCP) هو معيار مفتوح لربط نماذج AI بالأدوات ومصادر البيانات الخارجية. بإضافة كلمات كخادم MCP، تمنح Claude وCursor وأدوات AI المتوافقة الأخرى القدرة على البحث في الكلمات العربية وتحليل النصوص والتحقق من المفردات — دون كتابة أي كود رابط.

تُعرض كلمات كشف MCP الخاص بها عند GET https://api.kalimalab.com/v1/mcp وتقبل استدعاءات الأدوات عند POST https://api.kalimalab.com/v1/mcp. تتطلب استدعاءات الأدوات مفتاح API صالحاً.

الأدوات المتاحة

search_wordsابحث في الكلمات العربية بالنص وعدد الأحرف والجذر والوزن وتصنيف الكلام.

get_wordاحصل على التفاصيل اللغوية الكاملة لكلمة عربية واحدة.

get_daily_wordجلب كلمة اليوم الثابتة (نفس الكلمة طوال اليوم، بتوقيت UTC).

get_random_wordsاحصل على 1-20 كلمة عربية مختارة عشوائياً.

analyze_textرمّز مقطعاً عربياً وأعد إحصاءات تردد الكلمات والأحرف.

validate_wordsتحقق من ما يصل إلى 100 كلمة في قاعدة بيانات كلمات.

get_statsأعد إحصاءات قاعدة البيانات: إجمالي الكلمات والجذور والأوزان.

إعداد العميل

أضف ما يلي إلى إعدادات عميل MCP. جسر npx -y mcp-remote يُثبَّت تلقائياً.

{  "mcpServers": {    "kalimalab": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://api.kalimalab.com/v1/mcp"],      "env": { "KALIMALAB_API_KEY": "klmt_live_your_key_here" }    }  }}

ℹمواقع ملفات الإعداد

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
Cursor: ~/.cursor/mcp.json
Windsurf: ~/.windsurf/mcp.json

الاستخدام المباشر عبر HTTP

يمكنك أيضاً استدعاء نقطة نهاية MCP مباشرةً من أي عميل HTTP. البيان عام؛ استدعاءات الأدوات تتطلب مفتاح API الخاص بك.

1. جلب البيان

bash

curl https://api.kalimalab.com/v1/mcp

2. استدعاء أداة

Open in AIClaude ChatGPT Cursor

bash

curl -X POST "https://api.kalimalab.com/v1/mcp" \  -H "x-api-key: klmt_live_your_key_here" \  -H "Content-Type: application/json" \  -d '{"tool": "search_words", "input": {"q": "كتب", "limit": 5}}'

الاستجابة

response.json

{  "data": {    "data": [      { "id": "wrd_001", "word": "كتب", "meaning_en": "to write", "letter_count": 3 }    ],    "total": 47  },  "error": null,  "meta": { "requestId": "req_abc123", "responseTimeMs": 12 }}

✓جميع الأدوات تتبع نفس شكل الطلب

كل استدعاء أداة يستخدم { "tool": "...", "input": { ... } }. حقل data في الاستجابة هو مخرج الأداة الخام، مُغلَّف في غلاف كلمات القياسي.

نقطة نهاية الاكتشاف

تُخدّم كلمات البيان أيضاً في موقع well-known القياسي:

bash

curl https://api.kalimalab.com/.well-known/mcp.json

هذا يُعيد التوجيه إلى GET /v1/mcp ويُستخدم من قِبل وكلاء الاكتشاف المتوافقين مع MCP للكشف التلقائي عن الخادم.

Edit this page on GitHub

Previousالبدء السريع Nextالمصادقة