Cc Recommender

npm version npm downloads CI codecov License: MIT Node.js Version

🎯 Skills, Plugins, and MCP Server Recommendation MCP Server for Claude Code

English | 日本語

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)
• ⭐ Quality Scoring - Evaluates skills based on official status, stars, freshness, and source
• 🤖 Official Skills Discovery - Automatically discovers official skills from known organizations

Installation

Via npm (Recommended)

npm install -g cc-recommender

Local Build

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

For Cursor users: Use ~/.cursor/mcp.json instead of ~/.claude/settings.json

Option 1: Using npx (Recommended)

No installation required. Always uses the latest version.

Add to ~/.claude/settings.json (or ~/.cursor/mcp.json for Cursor):

{
  "mcpServers": {
    "cc-recommender": {
      "command": "npx",
      "args": ["-y", "cc-recommender"]
    }
  }
}

Option 2: Global Installation

Faster startup, works offline. Requires manual updates.

npm install -g cc-recommender

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "cc-recommender": {
      "command": "cc-recommender"
    }
  }
}

Option 3: Local Build (For Development)

git clone https://github.com/yuji0809/cc-recommender.git
cd cc-recommender
pnpm install
pnpm run build

Add to ~/.claude/settings.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	Official plugin marketplace	Daily
punkpeye/awesome-mcp-servers	Curated list of MCP servers	Daily
hesreallyhim/awesome-claude-code	List of skills/workflows/hooks	Daily

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):

{
  "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
GITHUB_TOKEN	GitHub personal access token (increases API rate limit from 60 to 5000 req/hour)	Not set
SKIP_SECURITY_SCAN	Skip security scanning during data fetch (for developers)	false

Notes:

• To fetch skills from GitHub repositories, a GitHub token is recommended to avoid rate limits. Create a token at https://github.com/settings/tokens with public_repo scope.

Development

For development setup and contribution guidelines, see:

• CONTRIBUTING.md - Contribution guide
• ARCHITECTURE.md - Architecture documentation

Quick Start for Developers

# 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.

To report a security vulnerability, please use GitHub Security Advisories.

Contributing

We welcome contributions! See CONTRIBUTING.md for details.

License

MIT

Author

Yuji