cc-recommender


> 🎯 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

$3

``bash
npm install -g cc-recommender
`

$3

`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

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

$3

No installation required. Always uses the latest version.

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

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

$3

Faster startup, works offline. Requires manual updates.

`bash
npm install -g cc-recommender
`

Add to ~/.claude/settings.json:

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

$3

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

Add to ~/.claude/settings.json:

`json
{
"mcpServers": {
"cc-recommender": {
"command": "node",
"args": ["/path/to/cc-recommender/dist/index.js"]
}
}
}
`

How to Use

$3

`
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
`

$3

`
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 |

$3

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

$3

| 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

$3

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

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

Contributing

We welcome contributions! See CONTRIBUTING.md for details.

License

MIT

Author

Yuji