Airweave Search
MCP server for searching Airweave collections with natural language queries.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http airweave-search 'https://mcp.airweave.ai/mcp' --header 'X-API-Key: <Your Airweave API key>' --header 'X-Collection-Readable-ID: <The Airweave collection readable ID to search>'
{
"mcpServers": {
"airweave-search": {
"type": "http",
"url": "https://mcp.airweave.ai/mcp",
"headers": {
"X-API-Key": "<Your Airweave API key>",
"X-Collection-Readable-ID": "<The Airweave collection readable ID to search>"
}
}
}
}
airweave-mcp-searchclaude mcp add airweave-search -e 'AIRWEAVE_API_KEY=<your airweave_api_key>' -e 'AIRWEAVE_COLLECTION=<AIRWEAVE_COLLECTION>' -e 'AIRWEAVE_BASE_URL=<AIRWEAVE_BASE_URL>' -- npx -y airweave-mcp-search@0.9.62
{
"mcpServers": {
"airweave-search": {
"command": "npx",
"args": [
"-y",
"airweave-mcp-search@0.9.62"
],
"env": {
"AIRWEAVE_API_KEY": "<your airweave_api_key>",
"AIRWEAVE_COLLECTION": "<AIRWEAVE_COLLECTION>",
"AIRWEAVE_BASE_URL": "<AIRWEAVE_BASE_URL>"
}
}
}
}
متغيرات البيئة
AIRWEAVE_API_KEYإلزامي سري Your Airweave API key for authenticationAIRWEAVE_COLLECTIONإلزامي The Airweave collection to searchAIRWEAVE_BASE_URLAirweave API base URL (defaults to https://api.airweave.ai)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
Open-source context retrieval layer for AI agents and RAG systems.
What is Airweave?
Airweave connects to your apps, tools, and databases, continuously syncs their data, and exposes it through a unified, LLM-friendly search interface. AI agents query Airweave to retrieve relevant, grounded, up-to-date context from multiple sources in a single request.
Where it fits
Airweave sits between your data sources and AI systems as shared retrieval infrastructure. It handles authentication, ingestion, syncing, indexing, and retrieval so you don't have to rebuild fragile pipelines for every agent or integration.
How it works
- Connect your apps, databases, and documents (50+ integrations)
- Airweave syncs, indexes, and exposes your data through a unified retrieval layer
- Agents query Airweave via our SDKs, REST API, MCP, or native integrations with popular agent frameworks
- Agents retrieve relevant, grounded context on demand
Quickstart
Cloud-hosted: app.airweave.ai
Self-hosted
git clone https://github.com/airweave-ai/airweave.git
cd airweave
./start.sh
Requires Docker and docker-compose
Supported Integrations
SDKs
pip install airweave-sdk # Python
npm install @airweave/sdk # TypeScript
from airweave import AirweaveSDK
client = AirweaveSDK(api_key="YOUR_API_KEY")
results = client.collections.search.instant(
readable_id="my-collection",
query="Find recent failed payments"
)
CLI
Search collections, manage sources, and trigger syncs from your terminal:
pip install airweave-cli
airweave auth login
airweave search "quarterly revenue figures" --collection finance-data
The CLI outputs rich interactive results in your terminal and clean JSON when piped — making it work for both developers and AI agents.
Tech Stack
- Frontend: React/TypeScript with ShadCN
- Backend: FastAPI (Python)
- Databases: PostgreSQL (metadata), Vespa (vectors)
- Workers: Temporal (orchestration), Redis (pub/sub)
- Deployment: Docker Compose (dev), Kubernetes (prod)
Contributing
We welcome contributions! See our Contributing Guide.
License
الأسئلة الشائعة
ما هو Airweave Search؟
MCP server for searching Airweave collections with natural language queries.
كيف أثبّت Airweave Search؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http airweave-search 'https://mcp.airweave.ai/mcp' --header 'X-API-Key: <Your Airweave API key>' --header 'X-Collection-Readable-ID: <The Airweave collection readable ID to search>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Airweave Search إلى مفتاح API؟
نعم. يتطلب AIRWEAVE_API_KEY, AIRWEAVE_COLLECTION, X-API-Key, X-Collection-Readable-ID، وتضبطها في إعداداته.
هل Airweave Search مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Airweave Search؟
ينشره airweave-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.