Npm Package Docs

NPM Package Docs MCP

IDE で npm パッケージの最新ドキュメントを直接利用できる、Model Context Protocol（MCP）ツールです。このツールは、パッケージの GitHub リポジトリ、または npm パッケージ自体に同梱されている README から最新のドキュメントを取得します。

機能

この MCP ツールを使うと、IDE（Cursor など）で古い情報や不完全な情報に頼ることなく、あらゆる npm パッケージの最新ドキュメントを参照できます。次のように動作します。

1. まず GitHub リポジトリを確認：パッケージに GitHub リポジトリがある場合、リポジトリのメインブランチ（master、main、develop の順に確認）から README を直接取得します
2. npm パッケージにフォールバック：GitHub リポジトリがない場合、パッケージの tarball をダウンロードし、同梱されているパッケージから README ファイルを抽出します
3. リアルタイムで更新：常に最新のドキュメントを取得し、最新情報を利用できるようにします

重要な理由

• 推測に頼る必要がありません：古くなっている可能性のある IDE の提案に頼らず、正確で最新のドキュメントを取得できます
• 開発体験が向上します：最新のドキュメントでパッケージの API と使用パターンを理解できます
• エラーを削減できます：古い API リファレンスや非推奨のメソッドを使うことによる問題を回避できます
• シームレスに統合できます：MCP プロトコルを介して IDE で直接動作します

提供されるツール

get_docs_for_npm_package

説明：あらゆる npm パッケージの最新ドキュメントを取得します

パラメーター：

• packageName（string）：npm パッケージの名前（例：「react」、「lodash」、「express」）

戻り値：GitHub リポジトリまたはパッケージの tarball から取得した README の内容（テキスト）

使用例：

// In your IDE, you can now ask for documentation like:
// "Show me the docs for express"
// "What's the latest API for react-router-dom?"
// "Get documentation for axios"

動作の仕組み

1. パッケージの検索：npm レジストリに問い合わせて、パッケージのメタデータを取得します
2. リポジトリの検出：パッケージに GitHub リポジトリの URL があるか確認します
3. GitHub から取得：利用可能な場合、リポジトリのメインブランチから README.md を取得します
4. tarball の展開：GitHub リポジトリがない場合、パッケージの tarball をダウンロードして展開し、README を探します
5. 内容の返却：ドキュメントの内容を IDE に返します

インストール

前提条件

• Node.js（v16 以降）
• Cursor IDE（または MCP 互換の IDE）

インストール

Cursor に追加

Cursor に手動で追加

Cursor の MCP 設定ファイル（通常は ~/.cursor/mcp.json にあります）を編集します：

{
  "mcpServers": {
    "npm-package-docs-mcp": {
      "command": "npx",
      "args": [
        "meanands/npm-package-docs-mcp"
      ]
    }
  }
}

5. Cursor を再起動：新しい MCP サーバーを読み込むため、Cursor IDE を再起動します

使用方法

インストール後、次の手順で Cursor からツールを利用できます。

1. コマンドパレットを開きます（Cmd/Ctrl + Shift + P）
2. 依頼内容を入力します。例：
   • 「express のドキュメントを取得」
   • 「react の最新ドキュメントを表示」
   • 「lodash v4 の新機能は？」

ツールが指定したパッケージの最新ドキュメントを取得して表示します。

開発

開発モードでの実行

npm run dev

本番環境向けのビルド

npm run build

プロジェクト構成

npm-docs-mcp/
├── src/
│   ├── server.ts          # Main MCP server implementation
│   └── types/
│       └── index.ts       # TypeScript type definitions
├── package.json
├── tsconfig.json
└── README.md

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

MIT License - 詳細は LICENSE ファイルをご覧ください。

サポート

問題が発生した場合や質問がある場合は、GitHub リポジトリで issue を作成してください。