OculusMind.AI

Fornece acesso MCP aos agentes OculusMind.AI que pesquisam na web, analisam ações e produtos, automatizam e agendam fluxos de trabalho e utilizam outras ferramentas de servidor MCP.

GitHub

Documentação

Agentes OculusMind

Ferramentas de código aberto para conversar com agentes OculusMind.AI — Uno, Vera e Maximus — a partir do seu próprio código ou de qualquer host MCP.

Duas formas de acesso:

Servidor MCP — coloque os agentes no Claude Code (ou em qualquer host que fale MCP) como ferramentas. Faça uma pergunta a Uno/Vera/Maximus diretamente do seu CLI. Veja servers/mcp.
Bibliotecas de cliente A2A — chame os agentes diretamente do seu programa pelo protocolo A2A (envie uma mensagem, transmita uma resposta, descubra capacidades). Disponível para TypeScript e Python.

Ambos falam o mesmo contrato de rede (docs/PROTOCOL.md) e usam a mesma autenticação — um token de portador que você emite a partir da sua conta (docs/AUTHENTICATION.md).

MCP vs. A2A. São padrões diferentes, e este projeto faz a ponte entre eles. Os próprios agentes são servidos via A2A (Agente-a-Agente). O servidor MCP aqui encapsula esses endpoints A2A como ferramentas MCP para que um host MCP possa chamá-los; o cliente A2A fala com eles nativamente. Escolha o que se adequar.

Início rápido — Servidor MCP no Claude Code

Emita OCULUSMIND_TOKEN em https://oculusmind.ai/integrations, depois:

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

Ou execute a partir de um clone

# 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"

Então, no Claude Code: "Use oculusmind para pedir à Vera que verifique as especificações do DJI Mini 5." As ferramentas ask_agent e list_agents aparecem como mcp__oculusmind__*.

Início 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);

Início 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)

Obtendo um token

Faça login em https://oculusmind.ai.
Abra a página Integrations.
Emita um token de portador (válido por 7 dias) e copie-o.
Forneça-o como OCULUSMIND_TOKEN (ou seu próprio armazenamento de segredos).

Detalhes completos, orientações de segurança e o plano de renovação de token: docs/AUTHENTICATION.md.

Estrutura

├── 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

Desenvolvimento

Este repositório é um único workspace npm. A partir da raiz:

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 faça commit de um token — os testes de integração leem OCULUSMIND_TOKEN do ambiente, e os arquivos .env* são ignorados pelo git.

Status

Inicial. Os clientes TypeScript e Python e o servidor MCP são a referência; os contratos de protocolo e autenticação são estáveis o suficiente para desenvolver em cima deles. Mudanças que quebram são possíveis até a versão 1.0.