libdocs

libdocs

libdocs は、すべてのコーディングエージェントが直面する疑問、つまり「このライブラリの現在のバージョンは、実際に何をするのか」に答えます。ライブラリ名を指定すると、Context7 互換のライブラリ ID を見つけ、そのライブラリの最新ドキュメントとコード例を取得します。必要に応じて特定のトピックに絞り、指定したトークン数の上限を設定できます。コマンドラインから、またはエージェント向けの MCP サーバーとして利用できます。

API キーは任意です。CONTEXT7_API_KEY が設定されている場合、libdocs はそれを Bearer トークンとして送信します。設定されていない場合、リクエストはトークンなしで送信されます。利用開始時のサインアップは不要です。

インストール

npx @reneturcios/libdocs resolve "next.js"

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/libdocs

コンテナはデフォルトで MCP サーバーとして起動します（下記を参照）。CLI として使用するには、CLI 引数を渡してください。

CLI

# Find the Context7-compatible IDs for a library name
libdocs resolve "next.js"
libdocs resolve react

# Fetch documentation for an exact library ID
libdocs docs /vercel/next.js
libdocs docs /vercel/next.js --topic routing --tokens 20000

libdocs --version

終了コード：成功時は 0、検索に失敗した場合（サービスから HTTP ステータスが返された場合はそれを含め、エラー内容を示します）は 1、使用方法に誤りがある場合は 2 です。

サービスの最小値である 10000 を下回るトークン数が指定された場合は 10000 に引き上げられます。これは上流の動作に準じています。

MCP サーバー

1 つのバイナリで両方の用途に対応します。mcp サブコマンドを実行すると、stdio MCP サーバーが起動します。

npx -y @reneturcios/libdocs mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "libdocs": {
      "command": "npx",
      "args": ["-y", "@reneturcios/libdocs", "mcp"],
      "env": {
        "CONTEXT7_API_KEY": "your-key-if-you-have-one"
      }
    }
  }
}

env ブロックは任意です。キーなしで実行する場合は、ブロック全体を省略してください。

ツール

ツール	入力	返される内容
resolve-library-id	libraryName（文字列、必須）	該当するライブラリの一覧。それぞれのタイトル、Context7 互換のライブラリ ID、説明、およびサービスが報告するトークン数、スニペット数、信頼度の数値が含まれます。
get-library-docs	context7CompatibleLibraryID（文字列、必須）、tokens（数値、任意）、topic（文字列、任意）	ライブラリのドキュメントとコード例をプレーンテキストで返します。topic が指定されている場合は、そのトピックに絞り込みます。

解決処理ではサービスの検索エンドポイントにアクセスします。ドキュメントはライブラリ ID ごとにプレーンテキストモードで取得されます。検索に失敗した場合（ID が不明、レート制限、ホストに到達できないなど）は、ツールエラーとして報告されます。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。