A 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. What are Awesome Lists? Awesome lists are community-curated collections of the best tools, libraries, and resources on any topic - from machine
Add this skill
npx mdskills install bh-rat/context-awesomeProvides AI agents access to 8500+ curated awesome lists with semantic search and filtering capabilities
1# context-awesome : awesome references for your agents23[](https://modelcontextprotocol.io)45A 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.67**What are Awesome Lists?**8Awesome 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.910Perfect for :111. Knowledge worker agents to get the most relevant references for their work122. The source for the best learning resources133. Deep research can quickly gather a lot of high quality resources for any topic.144. Search agents1516https://github.com/user-attachments/assets/babab991-e4ff-4433-bdb7-eb7032e9cd11171819## Available Tools2021### 1. `find_awesome_section`2223Discovers sections and categories across awesome lists matching your search query.2425**Parameters:**26- `query` (required): Search terms for finding sections27- `confidence` (optional): Minimum confidence score (0-1, default: 0.3)28- `limit` (optional): Maximum sections to return (1-50, default: 10)2930**Example Usage:**31"Give me the best machine learning resources for learning ML related to python in couple of months."32"What are the best resources for authoring technical books ?"33"Find awesome list sections about React hooks"34"Search for database ORMs in Go awesome lists"3536### 2. `get_awesome_items`3738Retrieves items from a specific list or section with token limiting for optimal context usage.3940**Parameters:**41- `listId` or `githubRepo` (one required): Identifier for the list42- `section` (optional): Category/section name to filter43- `subcategory` (optional): Subcategory to filter44- `tokens` (optional): Maximum tokens to return (min: 1000, default: 10000)45- `offset` (optional): Pagination offset (default: 0)4647**Example Usage:**48```49"Show me the testing tools section from awesome-rust"50"Get the next 20 items from awesome-python (offset: 20)"51"Get items from bh-rat/awesome-mcp-enterprise"52```535455## Installation5657### Remote Server (Recommended)5859Context Awesome is available as a hosted MCP server. No installation required!6061<details>62<summary><b>Install in Cursor</b></summary>6364Go to: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`6566```json67{68 "mcpServers": {69 "context-awesome": {70 "url": "https://www.context-awesome.com/api/mcp"71 }72 }73}74```75</details>7677<details>78<summary><b>Install in Claude Code</b></summary>7980```sh81claude mcp add --transport http context-awesome https://www.context-awesome.com/api/mcp82```83</details>8485<details>86<summary><b>Install in Windsurf</b></summary>8788```json89{90 "mcpServers": {91 "context-awesome": {92 "serverUrl": "https://www.context-awesome.com/api/mcp"93 }94 }95}96```97</details>9899<details>100<summary><b>Install in VS Code</b></summary>101102```json103"mcp": {104 "servers": {105 "context-awesome": {106 "type": "http",107 "url": "https://www.context-awesome.com/api/mcp"108 }109 }110}111```112</details>113114<details>115<summary><b>Install in Claude Desktop</b></summary>116117Navigate to Settings > Connectors > Add Custom Connector. Enter:118- Name: `Context Awesome`119- URL: `https://www.context-awesome.com/api/mcp`120</details>121122See [Additional Installation Methods](#additional-installation-methods) for other MCP clients.123124## Local Setup125126For development or self-hosting:127128```bash129git clone https://github.com/bh-rat/context-awesome.git130cd context-awesome131npm install132npm run build133```134135### Configuration136137#### Running the Server138139```bash140# Development mode (runs from source)141npm run dev -- [options]142143# Production mode (runs compiled version)144npm run start -- [options]145146Options:147 --transport <stdio|http|sse> Transport mechanism (default: stdio)148 --port <number> Port for HTTP transport (default: 3000)149 --api-host <url> Backend API host (default: https://api.context-awesome.com)150 --debug Enable debug logging151 --help Show help152```153154#### Examples155156```bash157# Run with default settings (stdio transport)158npm run start159160# Run with HTTP transport on port 3001161npm run start -- --transport http --port 3001162163# Run with custom API host and key164npm run start -- --api-host https://api.context-awesome.com165```166167### MCP Client Configuration168169<details>170<summary><b>Claude Desktop</b></summary>171172Add to your Claude Desktop configuration file:173174```json175{176 "mcpServers": {177 "context-awesome": {178 "command": "node",179 "args": ["/path/to/context-awesome/build/index.js"],180 "env": {181 "CONTEXT_AWESOME_API_HOST": "https://api.context-awesome.com"182 }183 }184 }185}186```187</details>188189<details>190<summary><b>Cursor/VS Code</b></summary>191192Add to your settings:193194```json195{196 "mcpServers": {197 "context-awesome": {198 "command": "node",199 "args": ["/path/to/context-awesome/build/index.js"],200 "env": {201 "CONTEXT_AWESOME_API_HOST": "https://api.context-awesome.com"202 }203 }204 }205}206```207</details>208209<details>210<summary><b>Custom Integration</b></summary>211212For HTTP transport:213214```bash215npm run start -- --transport http --port 3001 --api-host https://api.context-awesome.com216```217218Then configure your client to connect to `http://localhost:3001/mcp`219</details>220221222### Testing223224### With MCP Inspector225```bash226npm run inspector227```228229230### Debug Mode231232Enable debug logging to see detailed information:233234```bash235npm run start -- --debug236237# Or in development mode238npm run dev -- --debug239```240241## Additional Installation Methods242243<details>244<summary><b>Install in Cline</b></summary>245246```json247{248 "mcpServers": {249 "context-awesome": {250 "url": "https://www.context-awesome.com/api/mcp"251 }252 }253}254```255</details>256257<details>258<summary><b>Install in Zed</b></summary>259260```json261{262 "context_servers": {263 "context-awesome": {264 "url": "https://www.context-awesome.com/api/mcp"265 }266 }267}268```269</details>270271<details>272<summary><b>Install in Augment Code</b></summary>2732741. Click the hamburger menu2752. Select **Settings**2763. Navigate to **Tools**2774. Click **+ Add MCP**2785. Enter URL: `https://www.context-awesome.com/api/mcp`2796. Name: **Context Awesome**280</details>281282<details>283<summary><b>Install in Roo Code</b></summary>284285```json286{287 "mcpServers": {288 "context-awesome": {289 "type": "streamable-http",290 "url": "https://www.context-awesome.com/api/mcp"291 }292 }293}294```295</details>296297<details>298<summary><b>Install in Gemini CLI</b></summary>299300```json301{302 "mcpServers": {303 "context-awesome": {304 "httpUrl": "https://www.context-awesome.com/api/mcp"305 }306 }307}308```309</details>310311<details>312<summary><b>Install in Opencode</b></summary>313314```json315"mcp": {316 "context-awesome": {317 "type": "remote",318 "url": "https://www.context-awesome.com/api/mcp",319 "enabled": true320 }321}322```323</details>324325<details>326<summary><b>Install in JetBrains AI Assistant</b></summary>3273281. Go to `Settings` -> `Tools` -> `AI Assistant` -> `Model Context Protocol (MCP)`3292. Click `+ Add`3303. Configure URL: `https://www.context-awesome.com/api/mcp`3314. Click `OK` and `Apply`332</details>333334<details>335<summary><b>Install in Kiro</b></summary>3363371. Navigate `Kiro` > `MCP Servers`3382. Click `+ Add`3393. Configure URL: `https://www.context-awesome.com/api/mcp`3404. Click `Save`341</details>342343<details>344<summary><b>Install in Trae</b></summary>345346```json347{348 "mcpServers": {349 "context-awesome": {350 "url": "https://www.context-awesome.com/api/mcp"351 }352 }353}354```355</details>356357<details>358<summary><b>Install in Amazon Q Developer CLI</b></summary>359360```json361{362 "mcpServers": {363 "context-awesome": {364 "url": "https://www.context-awesome.com/api/mcp"365 }366 }367}368```369</details>370371<details>372<summary><b>Install in Warp</b></summary>3733741. Navigate `Settings` > `AI` > `Manage MCP servers`3752. Click `+ Add`3763. Configure URL: `https://www.context-awesome.com/api/mcp`3774. Click `Save`378</details>379380<details>381<summary><b>Install in Copilot Coding Agent</b></summary>382383```json384{385 "mcpServers": {386 "context-awesome": {387 "type": "http",388 "url": "https://www.context-awesome.com/api/mcp",389 "tools": ["find_awesome_section", "get_awesome_items"]390 }391 }392}393```394</details>395396<details>397<summary><b>Install in LM Studio</b></summary>3983991. Navigate to `Program` > `Install` > `Edit mcp.json`4002. Add:401402```json403{404 "mcpServers": {405 "context-awesome": {406 "url": "https://www.context-awesome.com/api/mcp"407 }408 }409}410```411</details>412413<details>414<summary><b>Install in BoltAI</b></summary>415416```json417{418 "mcpServers": {419 "context-awesome": {420 "url": "https://www.context-awesome.com/api/mcp"421 }422 }423}424```425</details>426427<details>428<summary><b>Install in Perplexity Desktop</b></summary>4294301. Navigate `Perplexity` > `Settings`4312. Select `Connectors`4323. Click `Add Connector`4334. Select `Advanced`4345. Enter Name: `Context Awesome`4356. Enter URL: `https://www.context-awesome.com/api/mcp`436</details>437438<details>439<summary><b>Install in Visual Studio 2022</b></summary>440441```json442{443 "inputs": [],444 "servers": {445 "context-awesome": {446 "type": "http",447 "url": "https://www.context-awesome.com/api/mcp"448 }449 }450}451```452</details>453454<details>455<summary><b>Install in Crush</b></summary>456457```json458{459 "$schema": "https://charm.land/crush.json",460 "mcp": {461 "context-awesome": {462 "type": "http",463 "url": "https://www.context-awesome.com/api/mcp"464 }465 }466}467```468</details>469470<details>471<summary><b>Install in Rovo Dev CLI</b></summary>472473```bash474acli rovodev mcp475```476477Then add:478479```json480{481 "mcpServers": {482 "context-awesome": {483 "url": "https://www.context-awesome.com/api/mcp"484 }485 }486}487```488</details>489490<details>491<summary><b>Install in Zencoder</b></summary>4924931. Go to Zencoder menu (...)4942. Select Agent tools4953. Click Add custom MCP4964. Name: `Context Awesome`4975. URL: `https://www.context-awesome.com/api/mcp`498</details>499500<details>501<summary><b>Install in Qodo Gen</b></summary>5025031. Open Qodo Gen chat panel5042. Click Connect more tools5053. Click + Add new MCP5064. Add:507508```json509{510 "mcpServers": {511 "context-awesome": {512 "url": "https://www.context-awesome.com/api/mcp"513 }514 }515}516```517</details>518519## Backend service520521This MCP server connects to backend API service that handles the heavy lifting of awesome list processing.522523The backend service will be open-sourced soon, enabling the community to contribute to and benefit from the complete context-awesome ecosystem.524525526## License527528MIT529530531## Contributing532533Contributions are welcome! Please:5345351. Fork the repository5362. Create a feature branch5373. Add tests for new functionality5384. Ensure all tests pass5395. Submit a pull request540541## Support542543For issues and questions:544- GitHub Issues: [https://github.com/your-org/context-awesome/issues](https://github.com/your-org/context-awesome/issues)545- Documentation: [https://docs.context-awesome.com](https://docs.context-awesome.com)546547## Attribution548549This 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.550551## Credits552553Built with:554- [Model Context Protocol SDK](https://github.com/anthropics/model-context-protocol)555- [Awesome Lists](https://github.com/sindresorhus/awesome)556- Inspired by [context7](https://github.com/upstash/context7) MCP server patterns557
Full transparency — inspect the skill content before installing.