cc-recommender 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2025-01-30
+
+### Added
+- Initial release of cc-recommender
+- MCP server for recommending Claude Code skills, plugins, and MCP servers
+- Project analysis based on languages, frameworks, and dependencies
+- 5 MCP tools:
+  - `recommend_skills` - Analyze project and recommend suitable items
+  - `search_skills` - Search by keyword
+  - `get_skill_details` - Get detailed information
+  - `list_categories` - List all categories
+  - `get_stats` - Get database statistics
+- Data sources:
+  - [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) - Official plugins
+  - [punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) - MCP servers
+  - [hesreallyhim/awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) - Skills/workflows/hooks
+- Auto-update feature:
+  - Fetches latest data from GitHub on startup
+  - Falls back to bundled data if remote fetch fails
+  - No manual updates required
+- Code quality tools:
+  - Biome for linting and formatting
+  - TypeScript strict mode
+  - cc-audit for security scanning
+  - Husky + lint-staged for pre-commit hooks
+- Developer experience:
+  - pnpm package manager
+  - Automatic weekly data updates via GitHub Actions
+  - Comprehensive documentation (README, CONTRIBUTING, ARCHITECTURE)
+
+[Unreleased]: https://github.com/yuji0809/cc-recommender/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/yuji0809/cc-recommender/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yuji
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,201 @@
+# cc-recommender
+
+[![npm version](https://img.shields.io/npm/v/cc-recommender.svg)](https://www.npmjs.com/package/cc-recommender)
+[![CI](https://github.com/yuji0809/cc-recommender/actions/workflows/ci.yml/badge.svg)](https://github.com/yuji0809/cc-recommender/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/yuji0809/cc-recommender/branch/main/graph/badge.svg)](https://codecov.io/gh/yuji0809/cc-recommender)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org/)
+
+> 🎯 Claude Code向けスキル/プラグイン/MCPサーバー推薦MCPサーバー
+
+[English](./README.md) | 日本語
+
+Claude Codeで「何入れたらいい？」と聞くだけで、プロジェクトを分析し、最適なスキル・プラグイン・MCPサーバーを提案します。
+
+## 特徴
+
+- 📦 **プラグイン推薦** - 公式マーケットプレイスから最適なプラグインを提案
+- 🔌 **MCPサーバー推薦** - awesome-mcp-serversからMCPサーバーを検索
+- 🎯 **スキル/ワークフロー推薦** - awesome-claude-codeからスキル、フック、コマンドを提案
+- 🔍 **プロジェクト分析** - 使用言語、フレームワーク、依存関係を自動検出
+- 🏷️ **キーワード検索** - 名前やタグで検索
+- 🔄 **自動更新** - GitHubから常に最新データを取得（手動更新不要）
+
+## インストール
+
+### npm経由（推奨）
+
+```bash
+npm install -g cc-recommender
+```
+
+### ローカルビルド
+
+```bash
+git clone https://github.com/yuji0809/cc-recommender.git
+cd cc-recommender
+pnpm install
+pnpm run build
+```
+
+**要件:**
+- Node.js >= 22.0.0
+- pnpm >= 10.0.0（ローカルビルドの場合）
+
+## Claude Codeで使う
+
+`~/.claude/settings.json` に追加:
+
+```json
+{
+  "mcpServers": {
+    "cc-recommender": {
+      "command": "npx",
+      "args": ["-y", "cc-recommender"]
+    }
+  }
+}
+```
+
+またはローカルビルドの場合:
+
+```json
+{
+  "mcpServers": {
+    "cc-recommender": {
+      "command": "node",
+      "args": ["/path/to/cc-recommender/dist/index.js"]
+    }
+  }
+}
+```
+
+## 使い方
+
+### プロジェクト分析と推薦
+
+```
+You: このプロジェクトに何を入れたらいい？
+
+Claude: [recommend_skills ツールを使用]
+
+📦 プラグイン
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+1. typescript-lsp (公式)
+   ├─ 用途: TypeScript の定義ジャンプ、型チェック
+   ├─ スコア: 95 ✅ 高適合
+   └─ インストール: /plugin install typescript-lsp
+
+🔌 MCPサーバー
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+1. supabase-mcp
+   ├─ 用途: Supabase DB 操作
+   ├─ 推薦理由: @supabase/supabase-js 依存
+   └─ インストール: claude mcp add supabase-mcp
+```
+
+### キーワード検索
+
+```
+You: データベース関連のMCPを探して
+
+Claude: [search_skills ツールを使用]
+```
+
+## 提供ツール
+
+| ツール | 説明 |
+|--------|------|
+| `recommend_skills` | プロジェクトを分析し、適切なスキル/プラグイン/MCPを推薦 |
+| `search_skills` | キーワードで検索 |
+| `get_skill_details` | 特定アイテムの詳細を取得 |
+| `list_categories` | カテゴリ一覧を取得 |
+| `get_stats` | データベース統計を取得 |
+
+## データソース
+
+このMCPサーバーは、以下のソースからデータを集約しています:
+
+| ソース | 内容 | 更新頻度 |
+|--------|------|---------|
+| [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) | 公式プラグインマーケットプレイス | 週次 |
+| [punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) | MCPサーバーのキュレーションリスト | 週次 |
+| [hesreallyhim/awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | スキル/ワークフロー/フックのリスト | 週次 |
+
+### 自動更新機能
+
+**仕組み:**
+- サーバー起動時にGitHubから最新データを自動取得
+- リモート取得に失敗した場合はバンドル版データにフォールバック
+- 手動更新や再インストール不要
+
+**オフラインモード**（オプション）:
+```json
+{
+  "mcpServers": {
+    "cc-recommender": {
+      "command": "npx",
+      "args": ["-y", "cc-recommender"],
+      "env": {
+        "CC_RECOMMENDER_OFFLINE_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+`CC_RECOMMENDER_OFFLINE_MODE` を有効にすると、バンドル版データのみを使用します（リモート取得なし）。
+
+### 環境変数
+
+| 変数 | 説明 | デフォルト |
+|------|------|-----------|
+| `CC_RECOMMENDER_OFFLINE_MODE` | 自動更新を無効化してバンドル版データのみを使用 | `false` |
+| `SKIP_SECURITY_SCAN` | データ取得時にセキュリティスキャンをスキップ（開発者向け） | `false` |
+
+## 開発
+
+開発セットアップと貢献ガイドラインについては、以下を参照してください:
+- [CONTRIBUTING.md](./CONTRIBUTING.md) - 貢献ガイド
+- [ARCHITECTURE.md](./docs/ARCHITECTURE.md) - アーキテクチャドキュメント
+
+### 開発者向けクイックスタート
+
+```bash
+# 依存関係インストール
+pnpm install
+
+# テスト実行
+pnpm run test
+
+# 型チェック + Lint + セキュリティ監査
+pnpm run check
+
+# ビルド
+pnpm run build
+```
+
+## セキュリティ
+
+このプロジェクトではセキュリティを最優先事項としており、複数の自動化されたセキュリティ対策を実施しています：
+
+- **自動スキャン**: Dependabot、CodeQL、カスタムセキュリティ監査
+- **プリコミット保護**: コミット前にセキュリティチェックを実行
+- **CI/CD ゲート**: すべての PR はセキュリティスキャンに合格する必要あり
+- **ライセンス準拠**: すべての依存関係が承認されたライセンスであることを検証
+
+詳細は [SECURITY.md](./SECURITY.md) を参照してください。
+
+セキュリティ脆弱性を報告する場合は、[GitHub Security Advisories](https://github.com/yuji0809/cc-recommender/security/advisories) をご利用ください。
+
+## コントリビューション
+
+貢献を歓迎します！詳細は [CONTRIBUTING.md](./CONTRIBUTING.md) を参照してください。
+
+## ライセンス
+
+[MIT](https://opensource.org/licenses/MIT)
+
+## 作者
+
+Yuji

package/README.md

@@ -0,0 +1,201 @@
+# cc-recommender
+
+[![npm version](https://img.shields.io/npm/v/cc-recommender.svg)](https://www.npmjs.com/package/cc-recommender)
+[![CI](https://github.com/yuji0809/cc-recommender/actions/workflows/ci.yml/badge.svg)](https://github.com/yuji0809/cc-recommender/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/yuji0809/cc-recommender/branch/main/graph/badge.svg)](https://codecov.io/gh/yuji0809/cc-recommender)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org/)
+
+> 🎯 Skills, Plugins, and MCP Server Recommendation MCP Server for Claude Code
+
+English | [日本語](./README.ja.md)
+
+Just ask "What should I install?" in Claude Code, and it will analyze your project and recommend the best skills, plugins, and MCP servers.
+
+## Features
+
+- 📦 **Plugin Recommendations** - Suggests optimal plugins from the official marketplace
+- 🔌 **MCP Server Recommendations** - Search MCP servers from awesome-mcp-servers
+- 🎯 **Skill/Workflow Recommendations** - Suggests skills, hooks, and commands from awesome-claude-code
+- 🔍 **Project Analysis** - Automatically detects languages, frameworks, and dependencies
+- 🏷️ **Keyword Search** - Search by name or tags
+- 🔄 **Auto-Update** - Always fetches the latest data from GitHub (no manual updates needed)
+
+## Installation
+
+### Via npm (Recommended)
+
+```bash
+npm install -g cc-recommender
+```
+
+### Local Build
+
+```bash
+git clone https://github.com/yuji0809/cc-recommender.git
+cd cc-recommender
+pnpm install
+pnpm run build
+```
+
+**Requirements:**
+- Node.js >= 22.0.0
+- pnpm >= 10.0.0 (for local build)
+
+## Usage with Claude Code
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "cc-recommender": {
+      "command": "npx",
+      "args": ["-y", "cc-recommender"]
+    }
+  }
+}
+```
+
+Or for local build:
+
+```json
+{
+  "mcpServers": {
+    "cc-recommender": {
+      "command": "node",
+      "args": ["/path/to/cc-recommender/dist/index.js"]
+    }
+  }
+}
+```
+
+## How to Use
+
+### Project Analysis and Recommendations
+
+```
+You: What should I install for this project?
+
+Claude: [Uses recommend_skills tool]
+
+📦 Plugins
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+1. typescript-lsp (Official)
+   ├─ Purpose: TypeScript definition jump, type checking
+   ├─ Score: 95 ✅ High Match
+   └─ Install: /plugin install typescript-lsp
+
+🔌 MCP Servers
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+1. supabase-mcp
+   ├─ Purpose: Supabase DB operations
+   ├─ Reason: Depends on @supabase/supabase-js
+   └─ Install: claude mcp add supabase-mcp
+```
+
+### Keyword Search
+
+```
+You: Find MCP servers related to databases
+
+Claude: [Uses search_skills tool]
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `recommend_skills` | Analyzes project and recommends appropriate skills/plugins/MCPs |
+| `search_skills` | Search by keywords |
+| `get_skill_details` | Get details of a specific item |
+| `list_categories` | Get list of categories |
+| `get_stats` | Get database statistics |
+
+## Data Sources
+
+This MCP server aggregates data from the following sources:
+
+| Source | Content | Update Frequency |
+|--------|---------|------------------|
+| [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) | Official plugin marketplace | Weekly |
+| [punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) | Curated list of MCP servers | Weekly |
+| [hesreallyhim/awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | List of skills/workflows/hooks | Weekly |
+
+### Auto-Update Feature
+
+**How it works:**
+- The server automatically fetches the latest data from GitHub when it starts
+- Falls back to bundled data if the remote fetch fails
+- No manual updates or reinstallation required
+
+**Offline Mode** (optional):
+```json
+{
+  "mcpServers": {
+    "cc-recommender": {
+      "command": "npx",
+      "args": ["-y", "cc-recommender"],
+      "env": {
+        "CC_RECOMMENDER_OFFLINE_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+When `CC_RECOMMENDER_OFFLINE_MODE` is enabled, only bundled data is used (no remote fetching).
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `CC_RECOMMENDER_OFFLINE_MODE` | Disable auto-updates and use only bundled data | `false` |
+| `SKIP_SECURITY_SCAN` | Skip security scanning during data fetch (for developers) | `false` |
+
+## Development
+
+For development setup and contribution guidelines, see:
+- [CONTRIBUTING.md](./CONTRIBUTING.md) - Contribution guide
+- [ARCHITECTURE.md](./docs/ARCHITECTURE.md) - Architecture documentation
+
+### Quick Start for Developers
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run tests
+pnpm run test
+
+# Type check + Lint + Security audit
+pnpm run check
+
+# Build
+pnpm run build
+```
+
+## Security
+
+Security is a top priority for this project. We employ multiple layers of automated security measures:
+
+- **Automated Scanning**: Dependabot, CodeQL, and custom security audits
+- **Pre-commit Protection**: Security checks run before every commit
+- **CI/CD Gates**: All PRs must pass security scans before merging
+- **License Compliance**: All dependencies are validated for approved licenses
+
+For more details, see [SECURITY.md](./SECURITY.md).
+
+To report a security vulnerability, please use [GitHub Security Advisories](https://github.com/yuji0809/cc-recommender/security/advisories).
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
+
+## License
+
+[MIT](https://opensource.org/licenses/MIT)
+
+## Author
+
+Yuji