Englisches Original: https://argusic.com/subject/ref-tools-mcp
ref-tools-mcp
Hilft Coding-Agents, bei der Arbeit mit öffentlichen oder privaten Bibliotheken keine Fehler zu machen, ohne das Kontextfenster zu verschwenden.
Läuft mit MocksQuelle: GitHubHomepageTypeScriptMITCommit 83970a356277
TypeScript, Lizenz MIT. Das Projekt beschreibt sich selbst als: coding agent, documentation tool, mcp und mcp server.
ref-tools-mcp läuft, mit Ersatz für die Dienste, von denen es abhängt. Ein Argusic-Agent hat es in 12 Minuten installiert und ist auf 3 Fehler gestoßen und hat jeden davon ohne Hilfe behoben. Das geschah auf einer sauberen Maschine ohne GPU, und die gesamte Sitzung wurde aufgezeichnet.
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.
Was der Agent auf einer sauberen Maschine erreicht hat, in seinen eigenen Worten. So wird gemessen
Von Argusic jedes Mal auf einer frischen Maschine gemessen. Jede Zahl verlinkt auf ihren Nachweis. Argusic Score 92 von 100 (der Mittelwert der Lauf-Scores dieses Projekts).
Auf einen Blick
Projektdaten von GitHub, oben auf dieser Seite verlinkt, aktualisiert . Testdaten von Argusic (CC BY 4.0); jede Zahl verlinkt auf eine Laufseite mit dem vollständigen Log, der Aufzeichnung und deren sha256-Hashes.
Was gemessen wurde
Aus dem Lauf, der diesen Befund entschieden hat. Jede Zeile ist ein aufgezeichneter Wert, keine Schätzung.
Was schiefging, in den Worten des Agents
Die eigenen Worte des Agents, das Schwerste zuerst, nie zu Ratschlägen umgeschrieben.
- Background mock/server processes terminated when their launching shell session ended4 Minuten
- Python urllib connected to localhost over IPv6, getting EADDRNOTAVAIL against the IPv4 HTTP listener2 Minuten
- Test client crashed on MCP notifications/initialized empty 202 response1 Minute
- Installationszeit
- 12 Minuten
- Von der kalten Maschine bis zum Ende
- 3 Minuten
- Aufgetretene und behobene Fehler
- 3 aufgetreten, 3 ohne menschliche Hilfe behoben
- Wie das Ergebnis belegt wurde
- 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
- Verbrauchte Modell-Tokens
- 49.590
- Genau getesteter Commit
- 83970a356277
- Container-Image
- sha256:cdd920bce783
Was nicht gemessen wurde
Die andere Hälfte, damit Sie genau sehen, wie weit dieser Nachweis reicht. Eine Lücke wird als Lücke angezeigt und nie aufgefüllt.
- Maximaler GPU-Speicher
- dieser Lauf fand auf einer CPU-Maschine statt, es gab also keine GPU zu messen
- Verhalten über einen langen Lauf
- jeder Versuch verwendet die kleinsten dokumentierten Einstellungen und ein festes Zeitbudget, daher misst dies, ob es läuft, nicht wie es sich unter Last hält
- Verhalten gegenüber echten Diensten
- dieser Lauf wurde nur gegen Ersatzdienste verifiziert
Das Ende der Aufzeichnung
Die letzten Zeilen der Terminalsitzung, die diesen Befund entschieden hat, genau so, wie sie aufgezeichnet wurden.
- 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**
Gesamte Sitzung abspielen, jeder Befehl von einer sauberen Maschine bis zu diesem Punkt.
So wurde getestet
Ein Agent, ein Container, keine menschliche Hilfe. Er installiert das Projekt so, wie es die eigene Dokumentation beschreibt, führt es aus und behebt, was nicht funktioniert. Alles Folgende wurde so aufgezeichnet, wie es geschah: die Terminalsitzung, das Log und der genaue Commit. Die vollständige Methodik.
Stärken und Grenzen
Gemessene Fakten, keine Meinungen. Wie diese Inhalte entstehen.
Was gut lief
- Hat sich von allen 3 Fehlern erholt, ohne dass ein Mensch eingriff, was zeigt, dass die Fehlschläge gut genug dokumentiert sind, um sie zu lösen.
- Lizenz MIT, laut Angabe des Hosts.
Was nicht lief oder unbekannt ist
- Hat einen lauffähigen Zustand nur gegen Ersatzdienste erreicht, daher belegt nichts hier, dass es mit den echten funktioniert.
- Die Installation dauerte 12 Minuten, langsamer als der Median der 4 vergleichbaren Projekte, die Argusic gemessen hat.
- Bisher einmal gemessen. Ein einzelner Versuch zeigt, dass es laufen kann, nicht dass es zuverlässig läuft.
Von den 5 Projekten im Bereich coding-agent, die Argusic installiert und zeitlich gemessen hat, belegte ref-tools-mcp Platz 4 bei der Zeit bis zum lauffähigen Zustand, und 1 von 5 erreichten überhaupt einen solchen Zustand.
Ebenfalls getestet, im selben Bereich
Jedes dieser Projekte wurde von Argusic auf einer sauberen Maschine installiert und ausgeführt. Hier erscheint nichts, was nicht getestet wurde.
Laufverlauf
| getestet von | Versuch | Ergebnis | Score | Kosten USD | wann |
|---|---|---|---|---|---|
| Argusic Runner | 1/3 | Läuft mit Mocks | 92,00 | 0,03 |
Themen (von GitHub)
Badge einbetten
Markdown für die README des Projekts. Es verlinkt hierher zurück; Bedingungen auf der Seite mit den Nutzungsbedingungen.
[](https://argusic.com/subject/ref-tools-mcp)Fragen
- Läuft ref-tools-mcp?
- ref-tools-mcp läuft, mit Mocks als Ersatz für externe Dienste. Argusic hat es auf einer sauberen Maschine in 12 Minuten installiert und gestartet, ist dabei auf 3 Fehler gestoßen und hat die Sitzung aufgezeichnet.
- Wie hat Argusic ref-tools-mcp getestet?
- Auf einer frischen Einwegmaschine, mit jedem Befehl aufgezeichnet und dem Repository fixiert auf Commit 83970a356277. Ein Versuch ist aufgezeichnet, und die vollständige Methode steht auf der Seite zur Methodik.
- Was hat der Test von ref-tools-mcp gekostet?
- Der Lauf, der diesen Befund ergab, kostete 0,03 USD: echte Rechen- und Modellkosten, kein Listenpreis pro Million Tokens. Der Betrag ist auf der Seite dieses Laufs aufgezeichnet.
- Wie lange dauert die Installation von ref-tools-mcp?
- 12 Minuten in dem Lauf, der diesen Befund entschieden hat, von einer sauberen Maschine bis zum lauffähigen Zustand. Das ist ein gemessener Versuch, kein Durchschnitt.
- Braucht ref-tools-mcp eine GPU?
- Nicht zum Starten. Argusic hat auf einer Maschine ohne GPU einen lauffähigen Zustand erreicht.
- Was geht bei der Installation von ref-tools-mcp schief?
- Im aufgezeichneten Lauf gingen 3 Dinge kaputt, und 3 davon wurden ohne menschliche Hilfe behoben. Jedes davon und die Zeit, die es gekostet hat, ist auf dieser Seite aufgeführt.
- Wie schneidet ref-tools-mcp im Vergleich zu Alternativen ab?
- Von den 5 Projekten im Bereich coding-agent, die Argusic installiert und zeitlich gemessen hat, belegte ref-tools-mcp Platz 4 bei der Zeit bis zum lauffähigen Zustand, und 1 von 5 erreichten überhaupt einen solchen Zustand.
- Wo ist der Nachweis für ref-tools-mcp?
- Der aufgezeichnete Lauf ist auf dieser Seite, jeweils mit Link auf das vollständige Log und die Terminalaufzeichnung, gespeichert mit einem sha256-Fingerabdruck, damit nichts unbemerkt verändert werden kann.