英語の原文: https://argusic.com/subject/ref-tools-mcp
ref-tools-mcp
コーディングエージェントがパブリックまたはプライベートなライブラリを扱う際に、コンテキストウィンドウを無駄にすることなく、決してミスをしないように支援します。
モックで動作するソース: GitHubホームページTypeScriptMITコミット 83970a356277
TypeScript、MIT ライセンス. プロジェクト自身の表記: coding agent、documentation tool、mcp、mcp server.
ref-tools-mcp は、依存するサービスを代わりのものに置き換えたうえで動作します。Argusic のエージェントが GPU のないクリーンなマシンで 12 分でインストールし、3 件のエラーに遭遇してすべてを自力で修正し、セッション全体が記録されました。
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.
クリーンなマシンでエージェントが最終的に得た結果 (エージェント自身の言葉)。 計測方法
Argusic が毎回新しいマシンで計測しています。 すべての数値はその証拠にリンクしています。 Argusic スコア 100 点中 92 点 (このプロジェクトの実行スコアの平均)。
概要
プロジェクトのデータは GitHub から取得 (このページの冒頭にリンクあり)、更新日 。テストデータは Argusic によるもので (CC BY 4.0)、すべての数値は、完全なログ、録画、それらの sha256 ハッシュを含む実行ページにリンクしています。
計測した内容
この判定を決めた実行から取得しています。 各行は記録された値であり、推定値ではありません。
うまくいかなかった点 (エージェント自身の言葉)
エージェント自身の言葉を、深刻なものから順に掲載しています。助言に書き換えることはありません。
- Background mock/server processes terminated when their launching shell session ended4 分
- Python urllib connected to localhost over IPv6, getting EADDRNOTAVAIL against the IPv4 HTTP listener2 分
- Test client crashed on MCP notifications/initialized empty 202 response1 分
- インストール時間
- 12 分
- クリーンなマシンから完了まで
- 3 分
- 遭遇したエラーと修正したエラー
- 3 件に遭遇、3 件を人の手を借りずに修正
- 結果の証明方法
- 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
- 使用したモデルのトークン
- 49,590
- テストした正確なコミット
- 83970a356277
- コンテナイメージ
- sha256:cdd920bce783
計測していない内容
残りの半分です。この証拠がどこまでを示すのかを正確に確認できます。欠けている部分は欠けているものとして表示し、埋めることはありません。
- GPU メモリのピーク
- CPU マシンで実行したため、サンプリングする GPU がありませんでした
- 長時間の実行での振る舞い
- 各試行はドキュメントにある最小の設定と決まった時間予算を使うため、計測しているのは動作するかどうかであり、負荷のもとでどう持ちこたえるかではありません
- 実際のサービスに対する振る舞い
- この実行は代わりのサービスに対してのみ検証されました
録画の最後
この判定を決めたターミナルセッションの最後の行を、記録されたとおりに表示しています。
- 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**
セッション全体を再生 (クリーンなマシンからこの時点までのすべてのコマンド)。
テスト方法
1 つのエージェント、1 つのコンテナで、人の手は借りません。エージェントはプロジェクト自身のドキュメントに書かれた方法でインストールし、実行し、壊れた部分を修正します。以下はすべて、実際に起きたとおりに記録されています: ターミナルセッション、ログ、そして正確なコミットです。 評価方法の全文.
強みと限界
意見ではなく、計測された事実です。コンテンツの作成方法.
うまくいった点
- 3 件のエラーすべてから、人の介入なしに回復しました。失敗が解決できる程度にはドキュメント化されていることを示しています。
- ホストの報告によると、ライセンスは MIT です。
うまくいかなかった点、または不明な点
- 代わりのサービスに対してのみ実行状態に達したため、実際のサービスで動作することはここでは証明されていません。
- インストールに 12 分かかり、Argusic が計測した比較可能な 4 件のプロジェクトの中央値より遅い結果です。
- これまでの計測は 1 回です。1 回の試行は動作し得ることを示すだけで、安定して動作することは示しません。
Argusic がインストールして時間を計測した coding-agent のプロジェクト 5 件のうち、ref-tools-mcp は実行状態に達するまでの速さが 4 番目で、5 件中 1 件がそもそも実行状態に達しました。
同じ分野でテストしたプロジェクト
ここに挙げたものはすべて、Argusic がクリーンなマシンにインストールして実行しました。テストしていないものは表示されません。
実行履歴
トピック (出典: GitHub)
バッジを埋め込む
プロジェクトの README に貼る Markdown です。バッジはこのページにリンクします。利用条件: 利用規約ページ.
[](https://argusic.com/subject/ref-tools-mcp)質問
- ref-tools-mcp は動作しますか?
- ref-tools-mcp は、外部サービスの代わりにモックを使って動作します. Argusic はクリーンなマシンで 12 分でインストールして起動し、途中で 3 件のエラーに遭遇し、セッションを記録しました。
- Argusic は ref-tools-mcp をどのようにテストしましたか?
- 新しい使い捨てのマシンで、すべてのコマンドを記録しながらテストしました (リポジトリはコミット 83970a356277 に固定)。記録された試行は 1 回で、手順の全体は評価方法のページに掲載しています。
- ref-tools-mcp のテストにはいくらかかりましたか?
- この判定を出した実行のコストは 0.03 USD です: 100 万トークンあたりの定価ではなく、実際の計算資源とモデルのコストです。その実行のページに記録されています。
- ref-tools-mcp のインストールにはどのくらい時間がかかりますか?
- この判定を決めた実行では、クリーンなマシンから実行状態まで 12 分でした。これは 1 回の計測された試行であり、平均ではありません。
- ref-tools-mcp には GPU が必要ですか?
- 起動には必要ありません。Argusic は GPU のないマシンで実行状態に達しました。
- ref-tools-mcp のインストールでは何がうまくいきませんか?
- 記録された実行では 3 件の問題が発生しました。そのうち 3 件は人の手を借りずに修正されました。それぞれの問題と、かかった時間をこのページに掲載しています。
- ref-tools-mcp は代替のプロジェクトと比べてどうですか?
- Argusic がインストールして時間を計測した coding-agent のプロジェクト 5 件のうち、ref-tools-mcp は実行状態に達するまでの速さが 4 番目で、5 件中 1 件がそもそも実行状態に達しました。
- ref-tools-mcp の証拠はどこにありますか?
- 記録された実行をこのページに掲載しており、それぞれが完全なログとターミナル録画にリンクしています。録画は sha256 フィンガープリントとともに保存されているため、こっそり改変することはできません。