OculusMind.AI

Proporciona acceso MCP a los agentes de OculusMind.AI que buscan en la web, analizan acciones y productos, automatizan y programan flujos de trabajo, y utilizan otras herramientas de servidores MCP.

GitHub

Documentación

OculusMind Agents

Herramientas de código abierto para hablar con agentes de OculusMind.AI — Uno, Vera y Maximus — desde tu propio código o desde cualquier host MCP.

Dos formas de acceso:

Servidor MCP — incorpora los agentes en Claude Code (o cualquier host que hable MCP) como herramientas. Haz una pregunta a Uno/Vera/Maximus directamente desde tu CLI. Consulta servers/mcp.
Bibliotecas de cliente A2A — llama a los agentes directamente desde tu programa a través del protocolo A2A (envía un mensaje, recibe una respuesta en streaming, descubre capacidades). Disponible para TypeScript y Python.

Ambos hablan el mismo contrato de red (docs/PROTOCOL.md) y usan la misma autenticación — un token de portador que generas desde tu cuenta (docs/AUTHENTICATION.md).

MCP vs. A2A. Son estándares diferentes, y este proyecto los conecta. Los agentes en sí se sirven a través de A2A (Agent-to-Agent). El servidor MCP de aquí envuelve esos endpoints A2A como herramientas MCP para que un host MCP pueda llamarlos; el cliente A2A habla con ellos de forma nativa. Elige el que mejor se adapte.

Inicio rápido — Servidor MCP en Claude Code

Genera OCULUSMIND_TOKEN en https://oculusmind.ai/integrations, luego:

claude mcp add oculusmind \
  --env OCULUSMIND_TOKEN=<your-token> \
  -- npx -y @oculusmind-ai/mcp-server

O ejecútalo desde un clon en su lugar

# npm install also builds the in-repo A2A client this depends on
cd servers/mcp && npm install && npm run build

claude mcp add oculusmind \
  --env OCULUSMIND_TOKEN=<your-token> \
  -- node "$(pwd)/dist/index.js"

Luego en Claude Code: "Usa oculusmind para pedirle a Vera que verifique las especificaciones del DJI Mini 5." Las herramientas ask_agent y list_agents aparecen como mcp__oculusmind__*.

Inicio rápido — Cliente A2A (TypeScript)

import { OculusMindAgents, StaticTokenProvider } from '@oculusmind-ai/agents';

const client = new OculusMindAgents({
  agent: 'vera', // or 'uno' | 'maximus'
  tokenProvider: new StaticTokenProvider(process.env.OCULUSMIND_TOKEN!),
});
const reply = await client.send('What is the weather in Austin?');
console.log(reply.text);

Inicio rápido — Cliente A2A (Python)

from oculusmind_ai_agents import OculusMindAgents, StaticTokenProvider

client = OculusMindAgents(
    agent="vera",  # or "uno" | "maximus"
    token_provider=StaticTokenProvider(os.environ["OCULUSMIND_TOKEN"]),
)
print(client.send("What is the weather in Austin?").text)

Cómo obtener un token

Inicia sesión en https://oculusmind.ai.
Abre la página Integrations.
Genera un token de portador (válido por 7 días) y cópialo.
Provéelo como OCULUSMIND_TOKEN (o tu propio gestor de secretos).

Detalles completos, guía de seguridad y el plan de renovación de tokens: docs/AUTHENTICATION.md.

Estructura

├── servers/
│   └── mcp/               MCP server for Claude Code & other MCP hosts
├── clients/
│   ├── typescript/        A2A client library (@oculusmind-ai/agents)
│   └── python/            A2A client library (oculusmind-ai-agents)
│                          The MCP server consumes the TypeScript client
│                          directly from this repo — one A2A implementation,
│                          not two. Wired as an npm workspace; nothing is
│                          fetched from a private registry.
├── docs/
│   ├── AUTHENTICATION.md  how to get a token + the refresh best-practice
│   ├── PROTOCOL.md        the A2A wire contract both speak
│   └── ROADMAP.md         languages, token auto-refresh
├── examples/              runnable samples
└── LICENSE · NOTICE

Desarrollo

Este repositorio es un único workspace de npm. Desde la raíz:

npm install
npm run check              # build + lint + typecheck + format + unit tests
npm run test:integration   # spawns the built MCP server over stdio

# Live tests against production are opt-in; without a token they self-skip.
OCULUSMIND_TOKEN=<your-token> npm run test:integration

Nunca confirmes un token — las pruebas de integración leen OCULUSMIND_TOKEN del entorno, y los archivos .env* están ignorados por git.

Estado

Etapa inicial. Los clientes de TypeScript y Python y el servidor MCP son la referencia; los contratos de protocolo y autenticación son lo suficientemente estables para construir sobre ellos. Es posible que haya cambios que rompan la compatibilidad hasta la versión 1.0.