---
title: "RunAPI MCP Server — 210+ نموذج ذكاء اصطناعي لـ Claude Code وCursor وVS Code"
url: "https://runapi.ai/ar/mcp.md"
canonical: "https://runapi.ai/ar/mcp"
locale: "ar"
---

# RunAPI MCP Server

اربط Claude Code وCursor وVS Code وWindsurf وأي مضيف متوافق مع MCP بـ RunAPI — وأنشئ صورًا وفيديوهات وموسيقى واستدعِ نماذج LLM من دون مغادرة المحرر.

## What Is RunAPI MCP Server?

يربط RunAPI MCP Server أدوات البرمجة المتوافقة مع MCP بمنصة RunAPI. يتيح لمساعدك الذكي تصفح 210+ نموذجًا عبر 23 مزودًا، وفحص معاملات الإدخال، والتحقق من التسعير الفوري، وإنشاء مهام توليد الوسائط، والاستعلام عن حالة المهام، والتحقق من رصيد حسابك، واستدعاء endpoints الخاصة بـ LLM — كل ذلك من داخل المحرر. تعمل أدوات الاكتشاف من دون API key. وتتطلب العمليات الموثقة مفتاح RunAPI API.

## Tools

| Tool | Auth | Purpose |
|---|---|---|
| list_models | No | Browse models by modality, service, or action. |
| get_model_info | No | Inspect input params, constraints, and pricing for a model. |
| list_actions | No | Group endpoint action names by output modality. |
| check_pricing | No | Return pricing snapshot for a service + action + model. |
| create_task | Yes | Create a media task and optionally poll until completion. |
| get_task | Yes | Fetch status and latest payload for an existing task. |
| check_balance | Yes | Return account balance and spending metrics. |
| chat | Yes | Send messages to a RunAPI LLM endpoint. |

## Quick Start

Choose the command for your MCP client.

### Claude Code

```bash
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
export RUNAPI_API_KEY="runapi_xxx"
claude
```

Use project scope when you want the repo to share `.mcp.json`:

```bash
claude mcp add runapi -s project -- npx -y @runapi.ai/mcp
```

### Codex

```bash
codex plugin install runapi-mcp@agents
export RUNAPI_API_KEY="runapi_xxx"
codex
```

### Cursor

```bash
npx @runapi.ai/mcp init cursor
export RUNAPI_API_KEY="runapi_xxx"
cursor .
```

### Windsurf

```bash
npx @runapi.ai/mcp init windsurf
export RUNAPI_API_KEY="runapi_xxx"
windsurf .
```

### VS Code

```bash
npx @runapi.ai/mcp init vscode
export RUNAPI_API_KEY="runapi_xxx"
code .
```

### Roo Code

```bash
npx @runapi.ai/mcp init roo
export RUNAPI_API_KEY="runapi_xxx"
code .
```

Free catalog tools work without a key.
Set `RUNAPI_API_KEY` for `create_task`, `check_balance`, and `chat`.
For GUI-launched clients, add the variable in the client's environment settings.

## Model Coverage

- **Image** — Flux Kontext, Nano Banana, GPT Image, Seedream, Ideogram, Qwen
- **Video** — Kling, Veo, Seedance, Hailuo, Wan, Runway, Luma
- **Music** — Suno v4 / v4.5 / v5 / v5.5
- **Audio** — ElevenLabs TTS, Sound Effects, STT, Isolation
- **LLM** — Claude, GPT, Gemini, DeepSeek

## FAQ

### هل أحتاج إلى مفتاح API لاستخدام RunAPI MCP Server؟

تعمل أدوات الاستكشاف مثل list_models و get_model_info و list_actions و check_pricing بدون مفتاح API. ولإنشاء المهام والتحقق من الرصيد والدردشة مع LLM، تحتاج إلى مفتاح RunAPI API مجاني من لوحة التحكم.

### ما أدوات البرمجة المدعومة؟

يعمل RunAPI MCP Server مع أي مضيف متوافق مع MCP: Claude Code و Codex و Cursor و VS Code (عبر GitHub Copilot) و Windsurf و Roo Code. ويمكن أيضًا تهيئته مع أي أداة تدعم بروتوكول MCP.

### ما نماذج الذكاء الاصطناعي التي يمكنني الوصول إليها عبر خادم MCP؟

210+ نموذجًا عبر 23 مزوّدًا و5 وسائط: توليد الصور (Flux و Nano Banana و GPT Image)، توليد الفيديو (Kling و Veo و Seedance)، إنشاء الموسيقى (Suno)، الصوت (ElevenLabs)، وLLMs (Claude و GPT و Gemini و DeepSeek).

### كيف أُثبّت خادم MCP؟

استخدم الأمر المناسب لعميلك. يستخدم Claude Code الأمر claude mcp add runapi -s user -- npx -y @runapi.ai/mcp. ويستخدم Codex الأمر codex plugin install runapi-mcp@agents. أما Cursor و Windsurf و VS Code و Roo Code فتستخدم npx @runapi.ai/mcp init <platform>. لا حاجة إلى تثبيت npm عالمي.

### هل خادم MCP مجاني؟

خادم MCP نفسه مجاني ومفتوح المصدر (Apache 2.0). ويتم احتساب استخدام API عبر حساب RunAPI بنظام الدفع حسب الاستخدام. لا اشتراكات ولا حد أدنى للإنفاق.

### هل يمكنني استخدام خادم MCP في CI أو البيئات بدون واجهة؟

نعم. اضبط متغير البيئة RUNAPI_API_KEY وتهيئة خادم MCP في وكيلك أو خط أنابيب CI. يعمل الخادم كعملية stdio ولا يتطلب متصفحًا أو واجهة رسومية.

### ما الأدوات المتاحة عبر خادم MCP؟

تتوفر 8 أدوات مدمجة — list_models وget_model_info وlist_actions وcheck_pricing تعمل بدون مفتاح API. أما create_task وget_task وcheck_balance وchat فتتطلب مفتاح RunAPI API.

### كم تكلّف استخدام RunAPI عبر خادم MCP؟

خادم MCP نفسه مجاني. يُفوتر استخدام API بالاستدعاء عبر حسابك في RunAPI دون اشتراكات أو حد أدنى للإنفاق. لا تُحتسب التوليدات الفاشلة.


## Links

- [Model catalog](https://runapi.ai/ar/models)
- [CLI](https://runapi.ai/ar/cli)
- [SDKs](https://runapi.ai/ar/sdk)
- [Skills](https://runapi.ai/ar/skills)
- [Pricing](https://runapi.ai/ar/pricing)
- [API docs](https://runapi.ai/ar/docs)
- [GitHub](https://github.com/runapi-ai/mcp)
- [npm](https://www.npmjs.com/package/@runapi.ai/mcp)