{
  "markdown": "# context-awesome : awesome references for your agents [![Awesome](https://awesome.re/badge.svg)](https://awesome.re)\n\n[![MCP Server](https://img.shields.io/badge/MCP-Server-blue)](https://modelcontextprotocol.io)\n\nA Model Context Protocol (MCP) server that provides access to all the curated awesome lists and their items. It can provide the best resources for your agent from sections of the 8500+ awesome lists on github and more then 1mn+ (growing) awesome row items.\n\n**What are Awesome Lists?**\nAwesome lists are community-curated collections of the best tools, libraries, and resources on any topic - from machine learning frameworks to design tools. By adding this MCP server, your AI agents get instant access to these high-quality, vetted resources instead of relying on random web searches.\n\nPerfect for :\n\n1. Knowledge worker agents to get the most relevant references for their work\n2. The source for the best learning resources\n3. Deep research can quickly gather a lot of high quality resources for any topic.\n4. Search agents\n\nhttps://github.com/user-attachments/assets/babab991-e4ff-4433-bdb7-eb7032e9cd11\n\n## Two Ways to Use Context Awesome\n\n| Mode           | Install                                                           | Good for                                                                   |\n| -------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------- |\n| **MCP Server** | point your agent at the hosted URL or spawn `context-awesome-mcp` | Claude Desktop, Cursor, Windsurf, VS Code — agents that natively speak MCP |\n| **CLI**        | `npm install -g context-awesome`                                  | Scripts, shell workflows, editors without MCP support, CI jobs             |\n\nBoth modes ship from the same npm package (`context-awesome`) and hit the same hosted backend.\n\n## MCP Tools\n\nEvery MCP tool has a 1:1 CLI subcommand — the server and the CLI expose the same operations.\n\n| Tool                   | CLI equivalent                        | What it does                                                         |\n| ---------------------- | ------------------------------------- | -------------------------------------------------------------------- |\n| `find_awesome_section` | `context-awesome sections <query...>` | Discover sections/categories across awesome lists matching a query   |\n| `search_awesome_items` | `context-awesome search <query...>`   | Full-text search across individual items (tools/libraries/resources) |\n| `get_awesome_items`    | `context-awesome items <target>`      | Fetch items from a known list + section, token-budgeted              |\n\n## CLI Commands\n\nThe CLI (`context-awesome`) talks directly to the hosted backend. For the MCP server, use the separate `context-awesome-mcp` binary (see **Installation — MCP Clients** below).\n\n```\ncontext-awesome <command> [options]\n\nCommands:\n  sections <query...>        Find sections matching a query\n  search <query...>          Search items (e.g., context-awesome search \"postgres orm\")\n  items <target>             Fetch items from a list (by owner/repo or listId)\n\nGlobals:\n  --api-host <url>           Backend API host (env: CONTEXT_AWESOME_API_HOST)\n  --api-key <key>            API key (env: CONTEXT_AWESOME_API_KEY)\n  --json                     Emit raw JSON (for scripts)\n```\n\n### Install the CLI\n\n```bash\nnpm install -g context-awesome\ncontext-awesome --help\ncontext-awesome search \"rate limiter\"\ncontext-awesome sections \"graph databases\"\n```\n\n### Use the CLI without installing\n\n```bash\nnpx context-awesome search \"vector database\"\n```\n\n## Installation — MCP Clients\n\n### Remote Server (Recommended)\n\nContext Awesome is available as a hosted MCP server. No installation required.\n\n<details>\n<summary><b>Install in Cursor</b></summary>\n\nGo to: `Settings` → `Cursor Settings` → `MCP` → `Add new global MCP server`\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Claude Code</b></summary>\n\n```sh\nclaude mcp add --transport http context-awesome https://www.context-awesome.com/api/mcp\n```\n\n</details>\n\n<details>\n<summary><b>Install in Claude Desktop</b></summary>\n\nSettings → Connectors → Add Custom Connector.\n\n- Name: `Context Awesome`\n- URL: `https://www.context-awesome.com/api/mcp`\n</details>\n\n<details>\n<summary><b>Install in Windsurf / VS Code / Zed / JetBrains / LM Studio / ...</b></summary>\n\nUse the same URL (`https://www.context-awesome.com/api/mcp`) with each client's \"add remote MCP\" UI. See the dedicated sections below for exact snippets.\n\n</details>\n\n### Local stdio (Claude Desktop, offline-capable)\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"context-awesome-mcp\", \"serve\", \"--transport\", \"stdio\"],\n      \"env\": {\n        \"CONTEXT_AWESOME_API_HOST\": \"https://api.context-awesome.com\"\n      }\n    }\n  }\n}\n```\n\n### Local HTTP transport (for custom integrations)\n\n```bash\nnpx context-awesome-mcp serve --transport http --port 3001\n# then point your client at http://localhost:3001/mcp\n```\n\n## Local Development\n\n```bash\ngit clone https://github.com/bh-rat/context-awesome.git\ncd context-awesome\nnpm install\nnpm run build\n\n# CLI\n./build/cli.js search \"graph databases\"\n\n# MCP server (stdio)\n./build/index.js --transport stdio\n\n# MCP Inspector\nnpm run inspector\n```\n\n## Backend service\n\nThis MCP server and CLI connect to backend API service that handles the heavy lifting of awesome list processing.\n\nThe backend service will be open-sourced soon, enabling the community to contribute to and benefit from the complete context-awesome ecosystem.\n\n## Additional Installation Methods\n\n<details>\n<summary><b>Install in Cline</b></summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Zed</b></summary>\n\n```json\n{\n  \"context_servers\": {\n    \"context-awesome\": {\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Augment Code</b></summary>\n\n1. Click the hamburger menu\n2. Select **Settings**\n3. Navigate to **Tools**\n4. Click **+ Add MCP**\n5. Enter URL: `https://www.context-awesome.com/api/mcp`\n6. Name: **Context Awesome**\n</details>\n\n<details>\n<summary><b>Install in Roo Code</b></summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Gemini CLI</b></summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"httpUrl\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Opencode</b></summary>\n\n```json\n\"mcp\": {\n  \"context-awesome\": {\n    \"type\": \"remote\",\n    \"url\": \"https://www.context-awesome.com/api/mcp\",\n    \"enabled\": true\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in JetBrains AI Assistant</b></summary>\n\n1. Go to `Settings` -> `Tools` -> `AI Assistant` -> `Model Context Protocol (MCP)`\n2. Click `+ Add`\n3. Configure URL: `https://www.context-awesome.com/api/mcp`\n4. Click `OK` and `Apply`\n</details>\n\n<details>\n<summary><b>Install in Kiro</b></summary>\n\n1. Navigate `Kiro` > `MCP Servers`\n2. Click `+ Add`\n3. Configure URL: `https://www.context-awesome.com/api/mcp`\n4. Click `Save`\n</details>\n\n<details>\n<summary><b>Install in Trae</b></summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Amazon Q Developer CLI</b></summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Warp</b></summary>\n\n1. Navigate `Settings` > `AI` > `Manage MCP servers`\n2. Click `+ Add`\n3. Configure URL: `https://www.context-awesome.com/api/mcp`\n4. Click `Save`\n</details>\n\n<details>\n<summary><b>Install in Copilot Coding Agent</b></summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"type\": \"http\",\n      \"url\": \"https://www.context-awesome.com/api/mcp\",\n      \"tools\": [\"find_awesome_section\", \"search_awesome_items\", \"get_awesome_items\"]\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in LM Studio</b></summary>\n\n1. Navigate to `Program` > `Install` > `Edit mcp.json`\n2. Add:\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in BoltAI</b></summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Perplexity Desktop</b></summary>\n\n1. Navigate `Perplexity` > `Settings`\n2. Select `Connectors`\n3. Click `Add Connector`\n4. Select `Advanced`\n5. Enter Name: `Context Awesome`\n6. Enter URL: `https://www.context-awesome.com/api/mcp`\n</details>\n\n<details>\n<summary><b>Install in Visual Studio 2022</b></summary>\n\n```json\n{\n  \"inputs\": [],\n  \"servers\": {\n    \"context-awesome\": {\n      \"type\": \"http\",\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Crush</b></summary>\n\n```json\n{\n  \"$schema\": \"https://charm.land/crush.json\",\n  \"mcp\": {\n    \"context-awesome\": {\n      \"type\": \"http\",\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Rovo Dev CLI</b></summary>\n\n```bash\nacli rovodev mcp\n```\n\nThen add:\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><b>Install in Zencoder</b></summary>\n\n1. Go to Zencoder menu (...)\n2. Select Agent tools\n3. Click Add custom MCP\n4. Name: `Context Awesome`\n5. URL: `https://www.context-awesome.com/api/mcp`\n</details>\n\n<details>\n<summary><b>Install in Qodo Gen</b></summary>\n\n1. Open Qodo Gen chat panel\n2. Click Connect more tools\n3. Click + Add new MCP\n4. Add:\n\n```json\n{\n  \"mcpServers\": {\n    \"context-awesome\": {\n      \"url\": \"https://www.context-awesome.com/api/mcp\"\n    }\n  }\n}\n```\n\n</details>\n\n## License\n\nMIT\n\n## Contributing\n\nContributions are welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch\n3. Add tests for new functionality\n4. Ensure all tests pass\n5. Submit a pull request\n\n## Support\n\nFor issues and questions:\n\n- GitHub Issues: [https://github.com/bh-rat/context-awesome/issues](https://github.com/bh-rat/context-awesome/issues)\n\n## Attribution\n\nThis project uses data from over 8,500 awesome lists on GitHub. See [ATTRIBUTION.md](./ATTRIBUTION.md) for a complete list of all repositories whose data is included.\n\n## Credits\n\nBuilt with:\n\n- [Model Context Protocol SDK](https://github.com/anthropics/model-context-protocol)\n- [Awesome Lists](https://github.com/sindresorhus/awesome)\n- Inspired by [context7](https://github.com/upstash/context7) MCP server patterns\n",
  "bytes": 11229,
  "sha": "33c25371c4455bc8990a04059fa20ec74aa95aeacac6ac687726997eca326771",
  "repo_slug": "bh-rat/context-awesome",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bh_rat_context_awesome_2ee3f364/readme"
}