Npm Sentinel MCP

🚀 NPM サーバーサイドツール

このツールは、NPM 関連のサーバーサイド機能を提供し、様々な NPM パッケージの情報取得や解析、管理を支援します。

🚀 クイックスタート

📦 インストール

NPX を使用する場合

# プラグインのインストール
npm install -g @nekzus/mcp-server

# サーバーの起動
npx @nekzus/mcp-server

設定ファイルの例

Claude Desktop を使用する場合

以下の内容を claude_desktop_config.json に追加してください。

{
  "mcpServers": {
    "npmAnalyzer": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@nekzus/mcp-server"]
    }
  }
}

設定ファイルの場所：

• Windows：%APPDATA%/claude-desktop/claude_desktop_config.json
• macOS：~/Library/Application Support/claude-desktop/claude_desktop_config.json
• Linux：~/.config/claude-desktop/claude_desktop_config.json

NPX を使用する場合

{
  "mcpServers": {
    "npm-sentinel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nekzus/mcp-server"
      ]
    }
  }
}

✨ 主な機能

リソースインターフェース

• npm://registry：NPM レジストリインターフェース
• npm://security：セキュリティ分析インターフェース
• npm://metrics：パッケージメトリクスインターフェース

ツールセット

npmVersions

• パッケージのすべてのバージョンを取得します。
• 入力：packages（文字列配列）
• 出力：バージョン履歴とそのリリース日

npmLatest

• 最新バージョンの情報を取得します。
• 入力：packages（文字列配列）
• 出力：最新バージョンの詳細情報と変更ログ

npmDeps

• パッケージの依存関係を分析します。
• 入力：packages（文字列配列）
• 出力：完全な依存関係ツリー分析

npmTypes

• TypeScript のサポートを確認します。
• 入力：packages（文字列配列）
• 出力：TypeScript 互換状態

npmSize

• パッケージのサイズを分析します。
• 入力：packages（文字列配列）
• 出力：バンドルサイズとインポートコスト分析

npmVulnerabilities

• セキュリティホールをスキャンします。
• 入力：packages（文字列配列）
• 出力：セキュリティアナウンスと深刻度評価

npmTrends

• ダウンロードトレンドを取得します。
• 入力：
  • packages（文字列配列）
  • period（"last-week" | "last-month" | "last-year"）
• 出力：指定された期間のダウンロード統計情報

npmCompare

• 複数のパッケージを比較します。
• 入力：packages（文字列配列）
• 出力：詳細な比較指標

npmMaintainers

• パッケージのメンテナを取得します。
• 入力：packages（文字列配列）
• 出力：メンテナ情報と活動状況

npmScore

• パッケージの品質スコアを取得します。
• 入力：packages（文字列配列）
• 出力：包括的な品質指標

npmPackageReadme

• パッケージの README ファイルを取得します。
• 入力：packages（文字列配列）
• 出力：整形された README 内容

npmSearch

• パッケージを検索します。
• 入力：
  • query（文字列）
  • limit（数値、オプション）
• 出力：一致するパッケージとそのメタデータ

npmLicenseCompatibility

• ライセンスの互換性を確認します。
• 入力：packages（文字列配列）
• 出力：ライセンス分析と互換性情報

npmRepoStats

• リポジトリの統計情報を取得します。
• 入力：packages（文字列配列）
• 出力：GitHub/リポジトリ指標

npm

• パッケージのメンテナを取得します。
• 入力：packages（文字列配列）
• 出力：メンテナ情報と活動状況

🔧 コンパイルとビルド

プロジェクト構造

your-project/
├── src/
│   ├── components/
│   └── pages/
├── public/
└── package.json

ビルドスクリプトの例

{
  "scripts": {
    "build": "webpack --mode production",
    "dev": "webpack --mode development"
  }
}

📄 ライセンス

MIT License

Copyright (c) 年 著者名。
このソフトウェアは MIT ライセンスの下で配布されています。

MIT ライセンスのコピーは同梱の LICENSE ファイルを参照するか、URL を訪問して詳細を確認できます。

Apache License 2.0

Copyright (c) 年 著者名。
このソフトウェアは Apache ライセンス 2.0 の下で配布されています。

Apache ライセンス 2.0 のコピーは同梱の LICENSE ファイルを参照するか、URL を訪問して詳細を確認できます。

👨‍💻 開発規約

コードスタイルガイド

• プロジェクトチームの JavaScript コード規約に従ってください。
• 最新バージョンの ESLint と Prettier を使用して、コードフォーマットを統一してください。

ドキュメント作成

• すべてのパブリック API に対して JSDoc 形式でドキュメントを作成してください。
• ドキュメントをコードと同期して更新し、正確性を保証してください。

バージョン管理

• セマンティックバージョニング規約（SEMVER）に従ってください。
• 新しいバージョンをリリースする際には、変更ログを記録してリモートリポジトリにプッシュしてください。

🤝 プロジェクトへの貢献

貢献ガイド

1. このプロジェクトをあなたのアカウントに Fork してください。
2. 新しい機能ブランチを作成します：git checkout -b feature/your-feature-name
3. 変更をコミットします：git add . && git commit -m 'あなたが行った変更を説明する'
4. あなたのリポジトリにプッシュします：git push origin feature/your-feature-name
5. 元のプロジェクトに Pull Request を作成してください。

コードレビュー

• すべてのコミットは少なくとも 1 人のメンテナによるコードレビューを受ける必要があります。
• コードがプロジェクトの品質基準とセキュリティ規約に準拠していることを確認してください。

👥 コミュニティサポート

質問とフィードバック

• GitHub リポジトリで質問を投稿してください：[Issues ページへのリンク]
• プロジェクトの Discord コミュニティに参加してください：[Discord 招待リンク]

貢献者への感謝

このプロジェクトに貢献してくれたすべてのボランティアとメンテナに感謝します。皆さんの努力により、このプロジェクトはより良いものになっています。