Context Awesome - MCP Server for 8,500+ Awesome Lists

Context Awesome Logo - Glasses icon representing curated awesome lists

Give your AI agents access to 8,500+ awesome lists with over 1.3M curated resources.

What are Awesome Lists?
Community-curated collections of the best tools, libraries, and resources on any topic - from ML frameworks to design tools. This MCP server lets your agents recommend high-quality, vetted resources instead of random search results.

Explore the Index

Every list is extracted into structured, agent-ready data and refreshed automatically. Here's what's inside right now.

List	Source	Stars	Resources	Updated
build-your-own-x Master programming by recreating your favorite technologies from scratch.	/codecrafters-io/build-your-own-x	519k	359	19 hours ago
awesome 😎 Awesome lists about all kinds of interesting topics	/sindresorhus/awesome	479k	701	19 hours ago
public-apis A collective list of free APIs	/public-apis/public-apis	444k	1.6k	18 hours ago
free-programming-books :books: Freely available programming books	/EbookFoundation/free-programming-books	391k	11k	7 hours ago
awesome-python An opinionated list of Python frameworks, libraries, tools, and resources	/vinta/awesome-python	305k	567	18 hours ago
awesome-selfhosted A list of Free Software network services and web applications which can be hosted on your own servers	/awesome-selfhosted/awesome-selfhosted	301k	1.3k	18 hours ago
the-book-of-secret-knowledge A collection of inspiring lists, manuals, cheatsheets, blogs, hacks, one-liners, cli/web tools and more.	/trimstray/the-book-of-secret-knowledge	230k	7	4 hours ago
computer-science 🎓 Path to a free self-taught education in Computer Science!	/ossu/computer-science	205k	68	18 hours ago
awesome-go A curated list of awesome Go frameworks, libraries and software	/avelino/awesome-go	176k	3k	18 hours ago
prompts.chat f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.	/f/prompts.chat	164k	2	14 hours ago

What is Context Awesome?

Context Awesome is a Model Context Protocol (MCP) server that provides instant access to the entire awesome lists ecosystem on GitHub. It enables AI agents to discover and retrieve high-quality, community-curated resources across any domain.

Demo: Using Context Awesome with Claude to find machine learning resources

✓Search across 8,500+ awesome lists with semantic understanding
✓1mn+ awesome curated resources.
✓Direct integration with Claude, Cursor, and VS Code
✓Token-optimized responses for efficient context usage

Installation

Quick Setup (Hosted Server)

Context Awesome is available as a hosted MCP server. No installation required! Just add the configuration to your MCP client:

Cursor

Settings → Cursor Settings → MCP → Add new global MCP server

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Claude Code

Run in terminal:

claude mcp add --transport http context-awesome https://www.context-awesome.com/api/mcp

Windsurf

Add to MCP config:

{
  "mcpServers": {
    "context-awesome": {
      "serverUrl": "https://www.context-awesome.com/api/mcp"
    }
  }
}

VS Code

Add to settings:

"mcp": {
  "servers": {
    "context-awesome": {
      "type": "http",
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add Custom Connector

• Name: Context Awesome
• URL: https://www.context-awesome.com/api/mcp

See installation for other MCP clients →

Local Installation (For Development)

1. Clone and Build

git clone https://github.com/bh-rat/context-awesome.git
cd context-awesome
npm install
npm run build

2. Configure for Local Use

Add to your MCP client configuration:

{
  "mcpServers": {
    "context-awesome": {
      "command": "node",
      "args": ["/path/to/context-awesome/build/index.js"],
      "env": {
        "CONTEXT_AWESOME_API_HOST": "https://api.context-awesome.com"
      }
    }
  }
}

3. Run the Server

# Default (stdio transport)

npm run start

# HTTP transport

npm run start -- --transport http --port 3001

Available MCP Tools

find_awesome_section

Discovers sections and categories across awesome lists matching your search query.

Parameters: query, confidence, limit

get_awesome_items

Retrieves items from a specific list or section with token limiting for optimal context usage.

Parameters: listId, section, tokens, offset

Example Queries

→ "Find the best machine learning resources for Python"

→ "What are the best resources for authoring technical books?"

→ "Show me testing tools from awesome-rust"

→ "Get React component libraries from awesome lists"

→ "Find database ORMs in Go awesome lists"

Additional Installation Methods

Cline

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Zed

{
  "context_servers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Augment Code

Click hamburger menu
Select Settings → Tools
Click + Add MCP
Enter URL: https://www.context-awesome.com/api/mcp

Roo Code

{
  "mcpServers": {
    "context-awesome": {
      "type": "streamable-http",
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Gemini CLI

{
  "mcpServers": {
    "context-awesome": {
      "httpUrl": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Opencode

"mcp": {
  "context-awesome": {
    "type": "remote",
    "url": "https://www.context-awesome.com/api/mcp",
    "enabled": true
  }
}

JetBrains AI Assistant

Settings → Tools → AI Assistant → MCP
Click + Add
Configure URL: https://www.context-awesome.com/api/mcp

Kiro

Navigate Kiro → MCP Servers
Click + Add
Configure URL: https://www.context-awesome.com/api/mcp

Trae

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Amazon Q Developer CLI

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Warp

Settings → AI → Manage MCP servers
Click + Add
Configure URL: https://www.context-awesome.com/api/mcp

Copilot Coding Agent

{
  "mcpServers": {
    "context-awesome": {
      "type": "http",
      "url": "https://www.context-awesome.com/api/mcp",
      "tools": ["find_awesome_section", "get_awesome_items"]
    }
  }
}

LM Studio

Navigate to Program → Install → Edit mcp.json

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

BoltAI

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Perplexity Desktop

Navigate Settings → Connectors
Click Add Connector → Advanced
Name: Context Awesome
URL: https://www.context-awesome.com/api/mcp

Visual Studio 2022

{
  "inputs": [],
  "servers": {
    "context-awesome": {
      "type": "http",
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Crush

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "context-awesome": {
      "type": "http",
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Rovo Dev CLI

Run: acli rovodev mcp

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

Zencoder

Zencoder menu (...) → Agent tools
Click Add custom MCP
Name: Context Awesome
URL: https://www.context-awesome.com/api/mcp

Qodo Gen

Open chat panel → Connect more tools → + Add new MCP

{
  "mcpServers": {
    "context-awesome": {
      "url": "https://www.context-awesome.com/api/mcp"
    }
  }
}

推荐订阅源

Show HN