Original em inglês: https://argusic.com/subject/ref-tools-mcp
ref-tools-mcp
Ajudando coding agents a nunca cometer erros ao trabalhar com bibliotecas públicas ou privadas sem desperdiçar a janela de contexto.
Executa com mocksfonte: GitHubpágina do projetoTypeScriptMITcommit 83970a356277
TypeScript, licença MIT. O projeto se descreve como: coding agent, documentation tool, mcp e mcp server.
ref-tools-mcp executa, com substitutos para os serviços de que depende. Em uma máquina limpa sem GPU, um agent da Argusic o instalou em 12 minutos e encontrou 3 erros, corrigindo todos sem ajuda, e a sessão inteira foi gravada.
After npm install, npm run build, and npm run check all succeeded, the app builds to an executable dist/index.cjs; the HTTP server answered 200 'pong' on /ping and a full MCP session (initialize, tools/list, tools/call search/read, prompts) returned 200 with correct results against a mock Ref API, while the stdio transport answered initialize with serverInfo Ref 3.0.3.
O que o agent conseguiu em uma máquina limpa, nas palavras dele. Como isto é medido
Medido pela Argusic em uma máquina nova, todas as vezes. Cada número tem link para as suas evidências. Pontuação Argusic 92 de 100 (a média das pontuações das execuções deste projeto).
Visão geral
Dados do projeto de GitHub, com link no topo desta página, atualizado em . Dados de teste da Argusic (CC BY 4.0); cada número tem link para uma página de execução com o log completo, a gravação e os hashes sha256 deles.
O que foi medido
Da execução que decidiu este veredito. Cada linha é um valor registrado, não uma estimativa.
O que deu errado, nas palavras do agent
As palavras do próprio agent, das piores para as menores, nunca reescritas como conselho.
- Background mock/server processes terminated when their launching shell session ended4 minutos
- Python urllib connected to localhost over IPv6, getting EADDRNOTAVAIL against the IPv4 HTTP listener2 minutos
- Test client crashed on MCP notifications/initialized empty 202 response1 minuto
- Tempo de instalação
- 12 minutos
- Da máquina limpa até o fim
- 3 minutos
- Erros encontrados e corrigidos
- 3 encontrados, 3 corrigidos sem ajuda humana
- Como o resultado foi comprovado
- curl http://127.0.0.1:8099/ping returned 200 with body 'pong'; npm run build and npm run check exited 0; a full MCP session over HTTP (initialize, tools/list, tools/call ref_search_documentation, tools/call ref_read_url, prompts/list, prompts/get) returned HTTP 200 with correct JSON-RPC results; stdio initialize on node dist/index.cjs returned serverInfo Ref 3.0.3
- Tokens de modelo usados
- 49.590
- Commit exato testado
- 83970a356277
- Imagem do container
- sha256:cdd920bce783
O que não foi medido
A outra metade, para você ver exatamente até onde estas evidências vão. Uma lacuna é mostrada como lacuna e nunca é preenchida.
- Pico de memória da GPU
- esta execução foi em uma máquina com CPU, então não havia GPU para medir
- Comportamento em uma execução longa
- cada tentativa usa as menores configurações documentadas e um orçamento de tempo fixo, então isto mede se ele executa, não como ele se comporta sob carga
- Comportamento com serviços reais
- esta execução foi verificada apenas com serviços substitutos
O fim da gravação
As últimas linhas da sessão de terminal que decidiu este veredito, exatamente como foram gravadas.
- Read the README: this is `ref-tools-mcp`, an MCP server (stdio by default, or HTTP via `TRANSPORT… - Ran a standard install: `npm install` succeeded (249 packages; Node 18 vs the inspector's `>=22.7… - Built: `npm run build` → `dist/index.cjs` (1.4 mb, executable `755`). Type-check: `npm run check`… - Launched HTTP server (`TRANSPORT=http PORT=8099`): printed `Ref MCP Server running on HTTP at htt… - Because real Ref API credentials would be required for the actual proxied calls, I stood up a sch… - Verified HTTP transport end-to-end: `initialize` → 200 + session id; `tools/list` → `ref_search_d… - Verified stdio transport: a `node dist/index.cjs` child responded on stdout to `initialize` with … **Errors encountered (all fixed by me)** - Background service processes died when their launching shell session ended — relaunched everythin… - Python `urllib` resolving `localhost` to IPv6 (`EADDRNOTAVAIL`) against the IPv4 listener — switc… - My test client crashed on the MCP `notifications/initialized` 202/empty response — made the parse… **Result JSON**
Reproduzir a sessão inteira, cada comando desde a máquina limpa até este ponto.
Como foi testado
Um agent, um container, nenhuma ajuda humana. Ele instala o projeto do jeito que a própria documentação do projeto manda, executa o projeto e corrige o que quebra. Tudo abaixo é registrado como aconteceu: a sessão de terminal, o log e o commit exato. A metodologia completa.
Pontos fortes e limites
Fatos medidos, não opiniões. Como este conteúdo é escrito.
O que deu certo
- Recuperou-se de todos os 3 erros sem que uma pessoa interviesse, o que indica que as falhas estão documentadas o suficiente para serem resolvidas.
- Licença MIT, segundo a plataforma onde o projeto está hospedado.
O que não deu certo, ou não se sabe
- Só chegou a um estado de execução com serviços substitutos, então nada aqui prova que ele funciona com os serviços reais.
- Levou 12 minutos para instalar, mais devagar que a mediana dos 4 projetos comparáveis que a Argusic mediu.
- Medido uma vez até agora. Uma única tentativa mostra que ele pode executar, não que executa de forma confiável.
Dos 5 projetos de coding-agent que a Argusic instalou e cronometrou, ref-tools-mcp foi o 4º mais rápido a chegar a um estado de execução, e 1 de 5 chegaram a esse estado.
Também testados, na mesma área
Cada um destes foi instalado e executado pela Argusic em uma máquina limpa. Nada aparece aqui sem ter sido testado.
Histórico de execuções
| testado por | tentativa | resultado | pontuação | custo USD | quando |
|---|---|---|---|---|---|
| Argusic Runner | 1/3 | Executa com mocks | 92,00 | 0,03 |
Tópicos (de GitHub)
Incorporar o selo
Markdown para o README do projeto. Ele tem link de volta para esta página; os termos estão na página de termos.
[](https://argusic.com/subject/ref-tools-mcp)Perguntas
- ref-tools-mcp executa?
- ref-tools-mcp executa, com mocks no lugar de serviços externos. A Argusic o instalou e iniciou em uma máquina limpa em 12 minutos, encontrando 3 erros no caminho, e gravou a sessão.
- Como a Argusic testou ref-tools-mcp?
- Em uma máquina nova e descartável, com cada comando gravado e o repositório fixado no commit 83970a356277. Há uma tentativa registrada, e a metodologia completa está na página da metodologia.
- Quanto custou testar ref-tools-mcp?
- A execução que produziu este veredito custou US$ 0,03: custo real de computação e de modelo, não um preço de tabela por milhão de tokens. Esse valor está registrado na página da execução.
- Quanto tempo leva para instalar ref-tools-mcp?
- 12 minutos na execução que decidiu este veredito, de uma máquina limpa até um estado de execução. É uma tentativa medida, não uma média.
- ref-tools-mcp precisa de GPU?
- Não para iniciar. A Argusic chegou a um estado de execução em uma máquina sem GPU.
- O que dá errado ao instalar ref-tools-mcp?
- 3 coisas quebraram na execução registrada, e 3 foram corrigidas sem ajuda humana. Cada uma, com o tempo que custou, está listada nesta página.
- Como ref-tools-mcp se compara às alternativas?
- Dos 5 projetos de coding-agent que a Argusic instalou e cronometrou, ref-tools-mcp foi o 4º mais rápido a chegar a um estado de execução, e 1 de 5 chegaram a esse estado.
- Onde estão as evidências de ref-tools-mcp?
- A execução registrada está nesta página, cada uma com link para o seu log completo e a sua gravação do terminal, guardados com uma impressão digital sha256 para que não possam ser alterados discretamente.