JinDaGe - airweave MCP Details

article

README

🚀 Airweave

Airweave 是一个用于 AI 智能体和 RAG 系统的开源上下文检索层，它能够连接应用、工具和数据库，持续同步数据，并通过统一的、对大语言模型友好的搜索界面将数据公开。AI 智能体可以通过一次请求从多个来源检索相关、可靠且最新的上下文信息。

🚀 快速开始

云托管版本：app.airweave.ai

点击链接即可访问云托管版本的 Airweave。

自托管版本

git clone https://github.com/airweave-ai/airweave.git
cd airweave
./start.sh

启动后可通过 http://localhost:8080 访问。

⚠️ 重要提示

自托管版本需要安装 Docker 和 docker-compose。

✨ 主要特性

什么是 Airweave？

Airweave 可以连接你的应用、工具和数据库，持续同步它们的数据，并通过统一的、对大语言模型友好的搜索界面将数据公开。AI 智能体可以通过一次请求从多个来源检索相关、可靠且最新的上下文信息。

适用场景

Airweave 作为共享检索基础设施，位于你的数据源和 AI 系统之间。它负责处理身份验证、数据摄取、同步、索引和检索，这样你就不必为每个智能体或集成重新构建脆弱的管道。

工作原理

连接：连接你的应用、数据库和文档（支持 50 多种集成）。
Airweave 处理：Airweave 同步、索引并通过统一的检索层公开你的数据。
智能体查询：智能体可以通过我们的 SDK、REST API、MCP 或与流行智能体框架的原生集成来查询 Airweave。
智能体检索：智能体根据需求检索相关、可靠的上下文信息。

📦 安装指南

自托管安装

git clone https://github.com/airweave-ai/airweave.git
cd airweave
./start.sh

启动后可通过 http://localhost:8080 访问。

💻 使用示例

基础用法

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(
    readable_id="my-collection",
    query="Find recent failed payments"
)

更多使用示例可参考文档和示例代码。

🔧 技术细节

技术栈

前端：使用 React/TypeScript 和 ShadCN 构建。
后端：采用 FastAPI（Python）。
数据库：使用 PostgreSQL 存储元数据，Vespa 存储向量数据。
工作流：使用 Temporal 进行编排，Redis 进行发布/订阅。
部署：开发环境使用 Docker Compose，生产环境使用 Kubernetes。

📄 许可证

本项目采用 MIT 许可证。

如果你有任何问题，可以加入 Discord 社区交流，也可以在 GitHub Issues 中反馈问题，还可以关注我们的 Twitter 获取最新动态。同时，我们欢迎大家参与项目贡献，具体贡献指南请参考 Contributing Guide。

airweave