Astreus

Integración con MCP

Conecta agentes con herramientas externas usando el Model Context Protocol. Aprende los patrones de configuración, las APIs y los ejemplos prácticos...

Conecta agentes con herramientas externas usando el Model Context Protocol.

Inicio rápido

Clonar el ejemplo completo

La forma más sencilla de empezar es clonar el repositorio del ejemplo completo:

git clone https://github.com/astreus-ai/examples
cd examples/mcp-integration
npm install

O instalar solo el paquete

Si prefieres construirlo desde cero:

npm install @astreus-ai/astreus

Configuración del entorno

# .env
OPENAI_API_KEY=sk-your-openai-api-key-here
DB_URL=sqlite://./astreus.db

Integración con servidor MCP

import { config } from 'dotenv';
import { Agent, Graph } from '@astreus-ai/astreus';

config();

async function main() {
  const mainAgent = await Agent.create({
    name: 'FileAnalysisAgent',
    model: 'gpt-4o',
    systemPrompt: 'You are a file analysis agent that processes files using graph-based workflows and MCP tools.'
  });

  const mcpConfig = {
    name: 'filesystem',
    command: "npx", 
    args: ["@modelcontextprotocol/server-filesystem", process.cwd()]
  };

  await mainAgent.addMCPServers([mcpConfig]);
  await new Promise(resolve => setTimeout(resolve, 3000));
  
  const analysisGraph = new Graph({
    name: 'File Summary Workflow',
    maxConcurrency: 1
  }, mainAgent);

  const readTask = analysisGraph.addTaskNode({
    name: 'File Reading',
    prompt: 'Read the content of "./info.txt" file and analyze it.',
    priority: 1
  });

  const summaryTask = analysisGraph.addTaskNode({
    name: 'Summary Creation', 
    prompt: 'Based on the analyzed file content from the previous task, create a concise summary and save it as "./summary.txt" file.',
    dependencies: [readTask],
    priority: 2
  });

  const result = await analysisGraph.run({ 
    stream: true,
    onChunk: (chunk) => {
      console.log(chunk);
    }
  });
}

main().catch(console.error);

Ejecutar el ejemplo

Si clonaste el repositorio:

npm run dev

Si lo construiste desde cero, crea un archivo index.ts con el código anterior y ejecuta:

npx tsx index.ts

Repositorio

El ejemplo completo está disponible en GitHub: examples/mcp-integration

Última actualización: 6 de julio de 2026