convez.ai
MCP ServerIntegração & APIsAvançado
grubbyhacker

YouKnowMe - MCP Server de RAG Pessoal

grubbyhacker/youknowme

RAG seguro e distribuído para agentes de chat, com embeddings flexíveis

Ver no GitHub
InicialPluginScore · de 0 a 100

Um MCP Server produção-ready que implementa busca semântica (RAG) sobre corpus pessoal ou corporativo, com suporte a embeddings locais ou remotos via OpenRouter. Serve como middleware seguro entre agentes de chat e índices de conhecimento, com ferramentas CLI para construção, validação e promoção de índices.

Instalação

$npx convez-ai grubbyhacker/youknowme

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
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 semanas
Versão
—
Issues abertas
11
Contribuidores
2

Casos de uso

  • Construir sistemas de RA pessoais ou corporativos com dados privados
  • Integrar busca semântica em aplicações de agentes de IA
  • Gerenciar e versionar índices de conhecimento em produção

Veredito

Projeto maduro e bem arquitetado para RAG em produção, com foco em segurança e modularidade. Excelente para quem precisa controlar corpus privado e embeddings, mas requer familiaridade com infraestrutura e Python.

README

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

YouKnowMe

YouKnowMe is the production project that will supersede the Phase 0 MCP proof of concept.

The preserved prototype lives in POC/ and is reference-only unless explicitly being maintained as the running prototype on the VPS.

Repository Layout

  • docs/ - PRD and supporting design documentation.
  • POC/ - preserved Phase 0 reference implementation.

Local Tooling

This repository uses mise and uv.

mise trust
mise install
mise run sync

Local RAG Demo

Phase 1 is local-first. The synthetic corpus in fixtures/corpus/ exercises the full build and query path without real personal data, OpenRouter, or the VPS.

mise run test
mise run lint
mise run demo
mise run eval
YKM_EMBEDDING_PROVIDER=openrouter mise run local-mcp-smoke
mise run container-smoke
mise run index-promotion-smoke

GitHub CI runs mise run lint and mise run test. Run both before opening or updating a PR that changes code, tests, packaging, or workflows.

Manual equivalent:

YKM_EMBEDDING_PROVIDER=fake uv run ykm build --corpus fixtures/corpus --out .ykm/demo-index
YKM_EMBEDDING_PROVIDER=fake uv run ykm query "weekly spa maintenance" --index .ykm/demo-index --tag spa
YKM_EMBEDDING_PROVIDER=fake uv run ykm eval --index .ykm/demo-index --cases fixtures/eval/synthetic.json

To use real embeddings later, create .env from .env.example, set OPENROUTER_API_KEY, and use:

YKM_EMBEDDING_PROVIDER=openrouter uv run ykm build --corpus /path/to/content-repo --out .ykm/openrouter-index

Private eval cases can live outside this repo and be passed with --cases /path/to/private-cases.json.

Generated indexes and logs live under .ykm/ and are ignored.

Live MCP CLI

Use ykm live to call the production MCP route from a development machine with local Cloudflare Access credentials in .env.

uv run ykm live health --pretty
uv run ykm live query "thermostat setup" --limit 2 --pretty
uv run ykm live feedback --category agent_note --comment "live CLI smoke" --dry-run --pretty

See docs/ykm-live-cli.md for auth variables, upload examples, and write-safety behavior.

Reusable Index Artifact Tools

Private corpus repositories can install this package and use the public YKM build tooling without publishing private corpus content through this public repository.

YKM_EMBEDDING_PROVIDER=openrouter uv run ykm build --corpus /path/to/ykmcorpus --out .ykm/prod-index
uv run ykm validate-index --index .ykm/prod-index
uv run ykm package-index --index .ykm/prod-index --out artifacts

package-index writes a versioned .tar.gz bundle, .sha256, and build-report.json. Production corpus artifacts should be produced by the private corpus repository CI, not by this public repo CI.

The local promotion smoke builds two fake index artifacts, relaunches a Docker container onto the new artifact, and verifies checksum failure leaves the active index unchanged:

mise run index-promotion-smoke

Container Packaging

Phase 1C runs the same local serving path in a container:

mise run container-smoke

The compose path mounts .ykm/real-index read-only and writes protected query logs under .ykm/container-smoke/logs. See docs/ykm-container-packaging.md for the packaging contract and manual docker compose commands.

Ver o original no GitHub

Bom para

Relacionados