# rag-agent-platform: Self-Host RAG Agents and MCP Tools

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/nedonion-rag-agent-platform
Generated for open source discovery and AI-assisted research.

A self-hosted Java and Next.js platform for combining document retrieval, LLM-powered agents, and MCP tools. It suits teams that want a configurable knowledge and agent workflow under their own infrastructure, with external services to operate.

GitHub: https://github.com/NEDONION/rag-agent-platform
OSRepos URL: https://osrepos.com/repo/nedonion-rag-agent-platform

## Summary

A self-hosted Java and Next.js platform for combining document retrieval, LLM-powered agents, and MCP tools. It suits teams that want a configurable knowledge and agent workflow under their own infrastructure, with external services to operate.

## Topics

- java
- self-hosted
- rag
- mcp
- nextjs
- knowledge-base
- vector-database

## Repository Information

Last analyzed by OSRepos: Wed Oct 14 2026 20:22:25 GMT+0100 (Western European Summer Time)
Detail views: 0
GitHub clicks: 0

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Overview

RAG Agent Platform brings document ingestion, vector search, model configuration, agent conversations, and MCP tool connections into one self-hosted application. It addresses the need to manage knowledge-based LLM workflows while keeping control of the application and data infrastructure.

It is aimed at teams willing to run a Java backend, web frontend, database, message broker, and object storage. The README describes an incomplete tool-import workflow, so MCP gateways and tool containers need manual configuration.

## Key Features

- Upload and process documents for retrieval from knowledge bases.
- Store vectors in PostgreSQL with the PGVector extension.
- Configure model providers and publish agents.
- Stream agent conversations to the frontend using Server-Sent Events.
- Connect agents to a configured MCP gateway and tool containers.
- Process document jobs asynchronously through RabbitMQ.
- Deploy the frontend and backend with Docker Compose, with CI/CD deployment support documented in the repository.

## Use Cases

- A team can create an internal knowledge assistant over its documents when it can operate PostgreSQL, RabbitMQ, and object storage.
- Platform engineers can provide configurable agents and model providers to users within a self-hosted workspace.
- Developers can explore RAG and MCP integration in one application, especially when they are prepared to configure the MCP gateway and containers themselves.
- Organizations that need to keep control of their deployment and data can evaluate the live demo first, then adapt the self-hosted setup to their infrastructure.

## Our Take

This is a broad self-hosted RAG and agent console with active recent development, but its single-contributor concentration and infrastructure footprint make operational ownership important.

**Good fit if:**
- You want a single Java and Next.js application for knowledge bases, agents, model configuration, and MCP connections.
- Your team can run PostgreSQL with PGVector, RabbitMQ, and S3-compatible storage, and is comfortable managing external model services.
- You want the flexibility of the MIT license to run and modify the platform.

**Look elsewhere if:**
- You need a turnkey MCP tool-import experience, since the README says gateway and container setup is manual.
- Your team cannot support the database, queue, object storage, and model-provider dependencies required for local deployment.
- You need a project with a broader maintainer base or a recent release history. Recent commits and merged pull requests indicate activity, but most of the code comes from one person and there have been no releases in over a year.

## Project Health

| Signal | Value |
|---|---|
| Status | **Active**: regular commits |
| Last commit | 2026-08-18 (2 months ago) |
| Commits, last 90 days | 48 |
| Releases, last 12 months | 0 |
| Contributors | 1 |
| Issues closed, last 90 days | 0 |
| Pull requests merged, last 90 days | 4 (typically merged in 0 days) |
| Project age | 14 months |

Checked on 2026-10-14 with the GitHub API.

## Project Facts

- Language: Java
- License: MIT
- Stars: 89
- Forks: 7
- Topics: ai-agent, mcp, nextjs, pgvector, rag, spring-boot
- Archived: no

## What You Need

Detected in the repository:

- Java (JVM) (from pom.xml)
- A Dockerfile, so it can run in a container; a Compose file sets up the related services
- Automated checks on GitHub Actions

## Getting Started

Prepare Java 17, Maven, Node.js, pnpm, PostgreSQL with PGVector, RabbitMQ, object storage, and model-provider settings. Then start the backend and frontend:

```bash
mvn spring-boot:run
cd frontend && pnpm install && pnpm dev
```

See the [README](https://github.com/NEDONION/rag-agent-platform#readme) for database setup, environment variables, and deployment details.

## License in Plain Words

**MIT** (permissive).

- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice
- Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

## Alternatives

- [53AIHub](https://osrepos.com/repo/53ai-53aihub): 53AIHub is an organization-facing portal that publishes and operates agents, prompts, tools, and knowledge bases, including integrations with other AI platforms.
- [rag-web-ui](https://osrepos.com/repo/rag-web-ui-rag-web-ui): RAG Web UI focuses on document ingestion and question answering, with configurable models and OpenAPI access rather than a broader agent and MCP platform.
- [MaxKB](https://osrepos.com/repo/1panel-dev-maxkb): MaxKB builds knowledge-grounded agents using workflows and external tools, while rag-agent-platform emphasizes configurable retrieval and MCP tool integration.

| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| **rag-agent-platform** | Java | MIT | 89 | Active |
| [53AIHub](https://osrepos.com/repo/53ai-53aihub) | Go | NOASSERTION | 4.3k | Active |
| [rag-web-ui](https://osrepos.com/repo/rag-web-ui-rag-web-ui) | TypeScript | Apache-2.0 | 3.3k | Quiet |
| [MaxKB](https://osrepos.com/repo/1panel-dev-maxkb) | Python | GPL-3.0 | 22.9k | Active |

## Considerations

- Deployment requires several services, including PostgreSQL with the vector extension, RabbitMQ, S3-compatible storage, model and reranker providers, and SMTP. The README does not list a GPU requirement.
- MCP integration is not fully self-service in the UI. Teams must configure the gateway and tool containers manually.
- The project is active, with regular recent commits and merged pull requests, but development is concentrated in one contributor. No releases were recorded in the past year, and no issues were closed in the past 90 days.
- The supplied requirements data reports no tests. The README also cautions that its Compose setup is a deployment reference, not a one-command installation, and describes external infrastructure and private image-registry assumptions.
- The MIT license permits broad use and modification, subject to its license terms and notice requirements.