convez.ai
MCP Server
ethicalvats

eagi-mcp-framework

ethicalvats/eagi-mcp-framework

Ver no GitHub
BomPluginScore · de 0 a 100

Production-grade framework for building and orchestrating MCP servers.

Instalação

$npx convez-ai ethicalvats/eagi-mcp-framework

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 5 meses
Versão
v0.2.0
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

EAGI (eagi-mcp-framework): Enterprise Model Context Protocol Framework

@eagi/sdk @eagi/cli create-eagi License

EAGI (Enterprise AGI) is a unified, production-grade framework for building and orchestrating Model Context Protocol (MCP) servers.

Designed for scalability, auditability, and safety, EAGI splits responsibilities between a Go Control Plane (Gateway) and a TypeScript Domain SDK. This hybrid architecture offers high-performance multiplexing, routing, and background scheduling in Go alongside a fast, type-safe developer experience in TypeScript.


Key Features

  • 🔌 Hooks: Robust hook engine supporting synchronous and asynchronous actions and filters (before:tool:call, filter:tool:output, etc.) to extend domain logic without modifying core server code.
  • 🛡️ Identity Projection: Enforce Role-Based Access Control (RBAC) at the Gateway. Authenticate users via OAuth/JWT, map identities to roles, and filter available tools dynamically before the LLM sees them.
  • 🗃️ Zod-to-MCP Schemas: Define tool inputs using standard Zod schemas; the SDK automatically builds and validates compliant JSON schemas.
  • ⏱️ Autonomous Triggers: High-performance cron scheduler built into the Go gateway to run background agent workflows autonomously.
  • 📝 Compliance-grade Audit Logging: Built-in cryptographic hash-chained audit logging and field-redaction middleware.
  • ⚡ Go process manager & proxy: Spawns long-lived domain Node.js processes, handles communications over stdio transport, and exposes them as a unified HTTP/SSE mesh.

Repository Structure

eagi/
├── package.json          # Monorepo configuration (pnpm workspaces)
├── packages/
│   ├── sdk/              # @eagi/sdk — Core framework SDK (TypeScript)
│   ├── cli/              # @eagi/cli — CLI tools (`eagi serve`, `eagi dev`)
│   └── create-eagi/      # create-eagi — Scaffolding bootstrapper
├── gateway/              # Go-based Control Plane/Gateway
├── examples/
│   └── gapbase/          # Sample domain server for testing
└── docs/                 # Getting started and primitives guides

Quick Start

1. Requirements

Make sure you have installed:

2. Installation

Clone this repository and install the dependencies:

pnpm install
pnpm build

3. Running GapBase Example

To test the monorepo with the included gapbase example:

Developer Mode (Stdio Transport)

Run the Domain SDK directly over standard input/output. This is fully compatible with local LLM environments like Claude Desktop or Claude Code:

cd examples/gapbase
npx eagi serve

Production Mode (Go Gateway + SSE Transport)

Run the Go Control Plane to launch and orchestrate the domain. This starts the SSE server proxying requests to the background domain processes:

cd gateway
DOMAIN_DIR=../examples/gapbase go run ./cmd/eagi-gateway

The gateway exposes a unified MCP SSE endpoint at http://localhost:3000/sse with identity mapping, triggers, and rate-limiting enabled.


MCP-Native & MCP-First Architecture

EAGI enables you to build MCP-Native applications:

  • Unified Communication: Both your React/Next.js frontend UI and your AI agents talk directly to the Go Gateway using the same MCP standard JSON-RPC protocol over Server-Sent Events (SSE).
  • Single Source of Truth: You do not write REST APIs and separate LLM tools. Business logic is defined once as tools (mutations) and resources (queries) in the TS Domain SDK.
  • MCP-First strategy: Expose and build your core system capabilities in the SDK first, making your application "Agent-Ready" from day one.

For more details, see the MCP-Native & MCP-First Guide.


Solving the 1000+ Tools Scaling Problem

One of the most common enterprise pain points is tool bloat. Loading hundreds or thousands of tools into the LLM context is slow, expensive, and degrades the model's reasoning capabilities.

EAGI solves this natively by decoupling the control plane (Go Gateway) from the execution plane (TypeScript SDK):

  • Identity Projection (RBAC): Prunes the toolset sent to the LLM by dynamically hiding tools the user's OAuth/JWT role is unauthorized to use.
  • Dynamic Tool Retrieval (Tool-RAG): Uses our powerful Hook Engine (filter:tools:list) to interface with vector databases and load only the 3–5 most semantically relevant tools based on user query intent.
  • Domain Partitioning: Splits monolithic backends into isolated, lightweight domain background processes managed by the gateway.

For more details, see the Context & Tool Scaling Guide.


Documentation

For deep dives into EAGI architecture and building custom domains:


Enterprise MCP Framework Comparison

EAGI is designed specifically for enterprise-grade deployments. Below is a comparison of EAGI against other major SDKs and frameworks in the MCP ecosystem:

FeatureEAGI (eagi-mcp-framework)Spring AI MCP (Java)McpDotNet (C#)Official SDKs (JS/Python)FastMCP (Python)
Primary LanguageGo (Gateway) + TS (SDK)JavaC# / .NETTypeScript / PythonPython
Orchestration MeshYes (spawns & monitors child processes)No (client only)No (client only)No (single server)No (single server)
Extension HooksYes (Actions & Filters engine)NoNoNoNo
Identity / RBACYes (projects OAuth JWT to tool filters)No (relies on Spring Security)NoNoNo
Background TriggersYes (built-in cron / webhook runners)NoNoNoNo
ObservabilityYes (structured hash-chained audit logs)Basic loggingBasic loggingBasic loggingBasic logging
Target PersonaProduction PlatformsJava Enterprise AppsC#/.NET Enterprise AppsProtocol DevelopersRapid Prototyping

License

This project is licensed under the Sustainable Use License (Fair-Code). See LICENSE for details. For commercial hosting, SaaS integration, or white-labeled redistribution, please contact us for a commercial license.

Ver o original no GitHub

Bom para

Relacionados