convez.ai
MCP ServerIntegração & APIsIntermediário
hiringbae

Oz MCP Setup

hiringbae/tryoz

Documentação versionada via MCP para agentes de IA

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server que fornece documentação versionada e sensível ao contexto para agentes de codificação. Permite que agents resolvam IDs de bibliotecas, busquem docs atualizadas e acessem exemplos de código exatos, evitando respostas baseadas em dados de treinamento desatualizados.

Instalação

$npx convez-ai hiringbae/tryoz

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
16
Forks
0
Acompanhando
0
Saúde
87%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Configurar agents (Claude, Cursor, Windsurf) com acesso a documentação de bibliotecas
  • Resolver versões exatas de APIs, frameworks e SDKs durante desenvolvimento
  • Fornecer contexto atualizado para geração de código com dependências externas

Veredito

Ferramenta sólida que resolve um problema real: agents gerando código com referências desatualizadas. A integração com múltiplos agentes e o setup interativo reduzem atrito, embora requeira chave de API do serviço Oz.

README

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

Oz MCP Setup

npm version license CI website

One-line setup for Oz, a version-aware documentation MCP server for coding agents.

npx tryoz setup

Oz gives agents a repeatable workflow for external library, SDK, framework, API, and package questions:

  1. Resolve the exact library ID.
  2. Fetch version-aware docs and code examples.
  3. Use exact API symbols, routes, env vars, config keys, and CLI flags from the returned context.
  4. Fall back to Context7, official docs, source repositories, or web search only when Oz does not have enough coverage.

Why Oz

Without a documentation MCP, coding agents often answer from old training data, guess APIs, or mix docs from the wrong major version.

With Oz, your agent can ask for the current indexed documentation at the moment it needs context.

User: Add Next.js middleware auth for v15.
Agent: resolve-library-id -> /vercel/next.js
Agent: get-library-docs -> version v15, topic middleware auth
Agent: answers from retrieved docs instead of guessing.

Setup Flow

npx tryoz setup is interactive by default:

The setup wizard:

  1. Detects installed coding agents.
  2. Shows a checkbox list with detected agents selected by default.
  3. Asks for scope: Global (recommended) or Project.
  4. Asks for an Oz API key. Keys must start with oz-.
  5. Shows the exact files and commands that will change.
  6. Installs the Oz MCP config.
  7. Installs the Oz skill or the best available rule fallback.
  8. Verifies the MCP server with tools/list.

No login flow. No broad hidden patching. Use --all when you want to configure every supported agent.

Supported Agents

AgentGlobalProjectSkill or policy
Codex CLI / Codex IDEYesYesCodex skill + AGENTS.md for project scope
Claude CodeYesYesClaude skill + CLAUDE.md for project scope
CursorYesYesCursor rule
VS Code / GitHub CopilotYesYesCopilot instructions for project scope
ClineYesYesMCP config + AGENTS.md for project scope
WindsurfYesYesWindsurf rules
OpenCodeYesYesOpenCode config + policy
GitHub Copilot CLIYesYesMCP config
GitHub Copilot Coding AgentProjectYesRepository MCP config
Grok BuildYesYesClaude-compatible project policy
Gemini CLIPolicyPolicyGEMINI.md policy

Common Commands

# Interactive setup
oz setup
npx tryoz setup

# Non-interactive setup
npx tryoz setup --codex --claude --global --api-key oz-your-key
npx tryoz setup --all --project --api-key oz-your-key

# Remove Oz-owned config only
oz logout
npx tryoz remove
npx tryoz logout
npx tryoz remove --codex --claude --global

# Verify the remote MCP endpoint
npx tryoz mcp test --api-key oz-your-key

# Inspect local agent config health
npx tryoz doctor --api-key oz-your-key

# List detected clients
npx tryoz list-agents
npx tryoz detect

Manual MCP Config

Use this endpoint for clients that you configure manually:

https://tryoz.dev/mcp

Pass your API key as a bearer token:

{
  "mcpServers": {
    "oz": {
      "type": "http",
      "url": "https://tryoz.dev/mcp",
      "headers": {
        "Authorization": "Bearer oz-your-key"
      }
    }
  }
}

Installed Skill

The bundled Oz skill and policy tell agents:

Use Oz first for external libraries, SDKs, APIs, frameworks, and packages.

Workflow:
1. Call `resolve-library-id` to find the exact Oz library ID.
2. Call `get-library-docs` with the resolved library ID and the user's topic.
3. If the user asks for a version, pass the version explicitly.
4. Use the returned documentation as the source of truth.
5. If Oz has no matching library, lacks the requested version, or returns insufficient context, then fall back to Context7, official docs, source repositories, or web search.

The full skill is packaged at templates/skills/oz/SKILL.md.

Documentation

Development

npm install
npm test
npm run pack:check
node bin/tryoz.js setup --dry-run --no-telemetry

Telemetry

Anonymous CLI telemetry records only command name, selected client IDs, OS/platform, success/failure, and CLI version. It does not send prompts, file contents, API keys, or absolute repository paths.

Disable telemetry with:

npx tryoz setup --no-telemetry

Security

Report security issues privately. See SECURITY.md.

Disclaimer

This repository contains the public Oz setup CLI, agent skills, rules, and docs. The hosted Oz indexing backend, crawler, vector store, and production dashboard are separate service components.

Oz indexes third-party documentation. Always validate critical changes against the upstream library or API owner when correctness or security matters.

License

MIT

Ver o original no GitHub

Bom para

Relacionados