MCP-RAG-AI-Agent

MCP搜索检索

提供方 bgiriaicloud

搜索检索 stdio · 本地进程 未标注 社区 / 第三方 Gemini CLIZed

A production-grade AI system combining Model Context Protocol, Retrieval-Augmented Generation, and AI Agents, deployed on Google Cloud Platform for enterprise AI applications.

一句话选型结论

按资料字段整理

MCP-RAG-AI-Agent 属于搜索检索类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Gemini CLI、Zed,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

Local Deployment AI Agents Retrieval-Augmented Generation Python Model Context Protocol Enterprise AI Google Cloud Platform

支持客户端

适用场景

Local DeploymentAI AgentsRetrieval-Augmented Generation

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Gemini CLI、Zed,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Gemini CLI、Zed 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP-RAG-AI-Agent当前 未标注 stdio · 本地进程 本地部署 无 2026-02-14
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bgiriaicloud上游标注的维护方 bgiriaicloud
分类搜索检索本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-02-14上游最后核验时间

详细介绍

8.2 KB
来自项目仓库与上游目录的原文,未做删改

MCP + RAG + AI Agent Architecture

> Production-grade implementation combining Model Context Protocol, Retrieval-Augmented Generation, and AI Agents on Google Cloud Platform

🎯 What Is This?

This project provides a complete, enterprise-ready implementation of a modern AI system that combines:

  • 🔌 MCP (Model Context Protocol): Standardized tool access for LLMs
  • 📚 RAG (Retrieval-Augmented Generation): Knowledge-enhanced AI responses
  • 🤖 AI Agents: Autonomous task orchestration with Gemini

All deployed on Google Cloud Platform following best practices for security, scalability, and observability.

✨ Key Features

  • ✅ Production-Ready: Enterprise-grade architecture
  • ✅ Fully Tested: Comprehensive test coverage
  • ✅ Well-Documented: Detailed guides and diagrams
  • ✅ GCP Best Practices: Security, scalability, observability
  • ✅ Modern Stack: Latest technologies and frameworks
  • ✅ Extensible: Easy to add new tools and features
  • ✅ Cost-Optimized: Serverless, pay-per-use model
  • ✅ DevOps Ready: GitHub Actions, Cloud Build, IaC, monitoring included

🚀 Quick Start

1. Validate Project Structure```bash

./validate_structure.sh


This ensures all required files are in place.

### 2. Local Development```bash
# Set up environment
cp .env.example .env
# Edit .env with your GCP project details

# Start all services
./quickstart.sh

# Access the application
# Web App: http://localhost:3000
# Agent Service: http://localhost:8000
# MCP Server: http://localhost:8080

3. Run Tests```bash

Unit tests

./run_tests.sh

Integration tests

./test_integration.sh


### 4. Deploy to GCP```bash
# Option 1: Cloud Build (Recommended)
gcloud builds submit --config cloudbuild.yaml .

# Option 2: Terraform
cd infrastructure
terraform init
terraform apply

📁 Project Structure```

mcp-rag-ai-agent/
├── src/
│ ├── agent-service/ # AI Agent orchestrator (FastAPI + Gemini)
│ ├── mcp-server/ # MCP tool server (FastAPI)
│ ├── rag-pipeline/ # RAG ingestion pipeline (Vertex AI)
│ └── web-app/ # Next.js frontend
├── infrastructure/ # Terraform IaC for GCP
│ ├── modules/
│ │ ├── networking/ # VPC, subnets, connectors
│ │ ├── compute/ # Cloud Run services
│ │ └── ai-platform/ # Vertex AI setup
│ ├── main.tf
│ ├── variables.tf
│ └── outputs.tf
├── docs/
│ ├── ARCHITECTURE.md # System architecture details
│ ├── DEPLOYMENT.md # Deployment guide
│ ├── TESTING.md # Testing guide
│ └── DIAGRAMS.md # Visual diagrams
├── docker-compose.yml # Local development
├── cloudbuild.yaml # CI/CD pipeline
├── quickstart.sh # Quick start script
├── run_tests.sh # Test runner
├── test_integration.sh # Integration tests
└── validate_structure.sh # Structure validator


## 🏗️ Architecture Overview```
┌─────────────────────────────────────────────────────────────────┐
│                         User Interface                          │
│                    (Next.js Web App)                            │
└────────────────────────┬────────────────────────────────────────┘
                         │ HTTPS
                         ▼
┌─────────────────────────────────────────────────────────────────┐
│                      AI Agent Service                           │
│                   (FastAPI + Gemini)                            │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐         │
│  │   Query      │  │     RAG      │  │     MCP      │         │
│  │  Processor   │  │  Retrieval   │  │   Client     │         │
│  └──────────────┘  └──────────────┘  └──────────────┘         │
└───────┬────────────────────┬────────────────────┬──────────────┘
        │                    │                    │
        ▼                    ▼                    ▼
┌──────────────┐   ┌──────────────────┐   ┌──────────────┐
│   Gemini     │   │  Vertex AI       │   │ MCP Server   │
│   3.0 Pro    │   │  Vector Search   │   │  (Tools)     │
└──────────────┘   └──────────────────┘   └──────────────┘

See docs/DIAGRAMS.md for detailed visual diagrams.

🛠️ Technology Stack

Component Technology Purpose
LLM Gemini 3.0 Pro Reasoning & generation
Vector DB Vertex AI Vector Search Semantic search
Embeddings textembedding-gecko@003 Document encoding
Agent Framework FastAPI + Vertex AI SDK Orchestration
MCP FastAPI Tool protocol
Frontend Next.js 14 + TypeScript User interface
Infrastructure Terraform IaC
CI/CD GitHub Actions / Cloud Build Automation
Compute Cloud Run Serverless
Storage Cloud Storage Documents
Networking VPC + Connector Security

📚 Documentation

  • ARCHITECTURE.md: Detailed system architecture and design decisions
  • DEPLOYMENT.md: Step-by-step deployment guide
  • TESTING.md: Testing strategies and examples
  • DIAGRAMS.md: Visual architecture diagrams
  • PROJECT_SUMMARY.md: Complete project summary

🧪 Testing

Unit Tests```bash

./run_tests.sh


Tests individual components:
- MCP Server endpoints
- Agent Service logic
- Tool execution
- Request/response validation

### Integration Tests```bash
./test_integration.sh

Tests the complete system:
- Service communication
- End-to-end workflows
- Docker Compose setup

Manual Testing```bash

Test MCP Server

curl http://localhost:8080/mcp/list_tools

Test Agent Service

curl -X POST http://localhost:8000/agent/chat \
-H "Content-Type: application/json" \
-d '{"query": "What tools are available?"}'
```

🔐 Security

  • VPC Isolation: Private networking for services
  • IAM: Least privilege service accounts
  • Secret Manager: Secure credential storage
  • Encryption: At rest and in transit
  • Audit Logging: Complete audit trail
  • Cloud Armor: DDoS and WAF protection

📈 Scalability

  • Cloud Run: Auto-scales from 0 to N instances
  • Vector Search: Handles millions of embeddings
  • Stateless Design: Horizontal scaling enabled
  • Multi-Region: Deploy across regions
  • CDN: Cloud CDN for static assets

💰 Cost Optimization

  • Scale to Zero: Cloud Run only charges for active requests
  • Efficient Embeddings: Batch processing
  • Resource Limits: Prevent runaway costs
  • Regional Deployment: Reduce egress charges

🎓 Learn More

Understanding the Components

  • Model Context Protocol
  • Vertex AI Vector Search
  • Vertex AI Gemini

GCP Resources

  • Cloud Run Documentation
  • Terraform on GCP
  • Cloud Build

🤝 Contributing

  1. Follow the existing code structure
  2. Add tests for new features
  3. Update documentation
  4. Run tests before committing
  5. Use conventional commits

📝 License

MIT License - see LICENSE file for details

🙋 Support

  • Check the documentation
  • Review the testing guide
  • Validate your setup: ./validate_structure.sh
  • Check logs: docker-compose logs -f

Built with ❤️ using GCP Best Practices

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP-RAG-AI-Agent 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP-RAG-AI-Agent 怎么在 Gemini CLI、Zed 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP-RAG-AI-Agent 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP-RAG-AI-Agent 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

MCP-RAG-AI-Agent 支持哪些客户端?

资料标注支持 Gemini CLI、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP-RAG-AI-Agent 能提供哪些能力?

资料显示能力标签包括 Local Deployment、AI Agents、Retrieval-Augmented Generation、Python、Model Context Protocol、Enterprise AI。具体工具清单以官方文档为准。

MCP-RAG-AI-Agent 需要什么运行环境?

运行时为 python;属于本地进程,需要在本机装好运行环境。

MCP-RAG-AI-Agent 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-02-14。