خادم Redis MCP هو خادم بروتوكول محتوى النموذج (Model Content Protocol) تم تطويره رسميًا بواسطة Redis، ويوفر واجهة لغة طبيعية لتطبيقات وكيل الذكاء الاصطناعي، مما يمكنها من إدارة بيانات Redis والبحث فيها بكفاءة. يتكامل هذا المشروع بسلاسة مع عميل MCP، ويدعم سير العمل المدعوم بالذكاء الاصطناعي للتفاعل مع البيانات المنظمة وغير المنظمة في Redis.
عنوان المشروع: https://github.com/redis/mcp-redis
يدعم جميع هياكل بيانات Redis الرئيسية:
# استنساخ المستودع
git clone https://github.com/redis/mcp-redis.git
cd mcp-redis
# استخدم uv لتثبيت التبعيات
uv venv
source .venv/bin/activate
uv sync
| اسم المتغير | الوصف | القيمة الافتراضية |
|---|---|---|
REDIS_HOST |
عنوان IP أو اسم مضيف Redis | "127.0.0.1" |
REDIS_PORT |
منفذ Redis | 6379 |
REDIS_USERNAME |
اسم مستخدم قاعدة البيانات | "default" |
REDIS_PWD |
كلمة مرور قاعدة البيانات | "" |
REDIS_SSL |
تمكين/تعطيل SSL/TLS | False |
REDIS_CA_PATH |
مسار شهادة CA | None |
REDIS_SSL_KEYFILE |
ملف المفتاح الخاص للعميل | None |
REDIS_SSL_CERTFILE |
ملف شهادة العميل | None |
REDIS_CERT_REQS |
ما إذا كان سيتم التحقق من شهادة الخادم | "required" |
REDIS_CA_CERTS |
مسار ملف شهادات CA الموثوقة | None |
REDIS_CLUSTER_MODE |
تمكين وضع مجموعة Redis | False |
MCP_TRANSPORT |
بروتوكول النقل (stdio/sse) | stdio |
# استخدم نقل stdio
uv run src/main.py
# قم بتعيين نقل SSE
export MCP_TRANSPORT="sse"
uv run src/main.py
# اختبار الخادم
curl -i http://127.0.0.1:8000/sse
# بناء الصورة
docker build -t mcp-redis .
# تشغيل الحاوية
docker run --rm --name redis-mcp-server -i \
-e REDIS_HOST=<redis_hostname> \
-e REDIS_PORT=<redis_port> \
-e REDIS_USERNAME=<redis_username> \
-e REDIS_PWD=<redis_password> \
mcp-redis
قم بتحرير ملف claude_desktop_config.json:
{
"mcpServers": {
"redis": {
"command": "<المسار الكامل لأمر uv>",
"args": [
"--directory",
"<دليل خادم MCP>",
"run",
"src/main.py"
],
"env": {
"REDIS_HOST": "<اسم مضيف Redis>",
"REDIS_PORT": "<منفذ Redis>",
"REDIS_PWD": "<كلمة مرور Redis>",
"REDIS_SSL": true,
"REDIS_CA_PATH": "<مسار شهادة CA>"
}
}
}
}
قم بتمكين وضع الوكيل وقم بتكوين mcp.json:
{
"servers": {
"redis": {
"type": "stdio",
"command": "<المسار الكامل لأمر uv>",
"args": [
"--directory",
"<دليل خادم MCP>",
"run",
"src/main.py"
],
"env": {
"REDIS_HOST": "<اسم مضيف Redis>",
"REDIS_PORT": "<منفذ Redis>",
"REDIS_USERNAME": "<اسم مستخدم Redis>",
"REDIS_PWD": "<كلمة مرور Redis>"
}
}
}
}
# تثبيت SDK
pip install openai-agents
# تكوين مفتاح API
export OPENAI_API_KEY="<openai_token>"
# تشغيل التطبيق
python3.13 redis_assistant.py
# استخدم Smithery لتكوين Claude Desktop تلقائيًا
npx -y @smithery/cli install @redis/mcp-redis --client claude
# تصحيح مرئي
npx @modelcontextprotocol/inspector uv run src/main.py
# مراقبة سجلات Claude
tail -f ~/Library/Logs/Claude/mcp-server-redis.log
يمكن استكشاف أخطاء سير عمل الوكيل وإصلاحها من خلال لوحة معلومات OpenAI.
feature-branch)خادم Redis MCP هو أداة قوية تسد الفجوة بين وكلاء الذكاء الاصطناعي وقواعد بيانات Redis، مما يمكّن تطبيقات الذكاء الاصطناعي من إدارة البيانات والاستعلام عنها بذكاء أكبر من خلال واجهة لغة طبيعية. سواء كنت تقوم ببناء مساعدين أذكياء أو روبوتات محادثة أو إجراء تحليل للبيانات في الوقت الفعلي، فإن هذا المشروع يوفر حلاً موثوقًا وفعالًا.
تصميمه المعياري ودعمه الغني لهياكل بيانات Redis وطرق النشر المتعددة تجعله مناسبًا لمجموعة متنوعة من السيناريوهات من المشاريع الصغيرة إلى تطبيقات المؤسسات. من خلال التكامل مع الأنظمة الأساسية السائدة مثل Claude و VS Code و OpenAI، يمكن للمطورين دمج قوة Redis بسهولة في تطبيقاتهم المدعومة بالذكاء الاصطناعي.