@arises-games/forge-rag

MCP server RAG do Arises Forge — busca lexical BM25 em agentes e knowledge do core decifrado (.forge-standard). Provider de busca plugável. Publicado em @arises-games/forge-rag (npm público).

Pré-requisitos

cd tools/rag-mcp
npm install   # instala @modelcontextprotocol/sdk

Variáveis de ambiente

| Variável | Descrição | Padrão | |---------|-----------|--------| | FORGE_CORE | Caminho para .forge-standard | Auto-detectado |

Uso

# Execução
forge-rag

# Ou via npx
npx @arises-games/forge-rag

Configuração MCP (claude_desktop_config.json)

{
  "mcpServers": {
    "forge-rag": {
      "command": "forge-rag"
    }
  }
}

Tools MCP

| Tool | Descrição | |------|-----------| | search | Busca BM25 em agentes e knowledge por nome, título, stack ou descrição | | index_status | Retorna status da indexação atual (total de documentos, última atualização) |

Parâmetros

search:

• query (string, obrigatório) — termo de busca
• limit (number, opcional, padrão 10) — número máximo de resultados

Indexação

O lib/indexer.js varre automaticamente:

.forge-standard/
├── agents/        orchestrators/ + experts/**/*.md
├── knowledge/     **/*.md
└── commands/      **/*.md

Extrai de cada arquivo: name, display, title, stack, level, description (frontmatter YAML + primeiro parágrafo H2 como fallback).

Roadmap

• [ ] Pipeline de embeddings (modelo a definir — ex: text-embedding-3-small, local via llama.cpp)
• [ ] Vector store (hnswlib / sqlite-vss / pgvector — a decidir)
• [ ] Indexação incremental (watch mode)
• [ ] search_commands com busca semântica

Arises Games Studios — Arises Forge v1.0.0