关于 Context Awesome
Context Awesome 是用于搜索精选 awesome 列表及其条目的 MCP 服务和 CLI,帮助研究与知识工作 Agent 查找特定主题的工具、库和学习资源。
主要功能
- 01发现匹配的列表分类
- 02全文搜索列表条目
- 03按列表和分类获取条目
- 04MCP 服务与 CLI 提供相同操作
适用场景
- 01查找特定技术主题的库
- 02为研究收集学习资源
- 03为 Agent 搜索精选参考资料
MCP 相关
MCP 服务提供工具,用于发现 awesome 列表分类、搜索单条内容,以及从指定列表和分类获取条目。可通过托管远程端点或本地传输使用。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://www.context-awesome.com/api/mcpclaude mcp add --transport http bh-rat-context-awesome https://www.context-awesome.com/api/mcp{"mcpServers":{"bh-rat-context-awesome":{"type":"http","url":"https://www.context-awesome.com/api/mcp"}}}在 Cursor 中打开{"servers":{"bh-rat-context-awesome":{"type":"http","url":"https://www.context-awesome.com/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"bh-rat-context-awesome":{"type":"http","url":"https://www.context-awesome.com/api/mcp"}}}{"mcpServers":{"bh-rat-context-awesome":{"serverUrl":"https://www.context-awesome.com/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
2| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | number | 否 | 最多返回的分区数 |
| query | string | 是 | 用于在 awesome 列表中查找章节的搜索词 |
| confidence | number | 否 | 最低置信度分数(0-1) |
详细介绍
context-awesome:为 Agent 提供精彩参考资料 
一个 Model Context Protocol (MCP) 服务,可访问所有经过精选的精彩列表及其中的条目。它能从 GitHub 上 8500 多个精彩列表的各个部分,以及超过 100 万条(还在不断增长)精彩条目中,为你的 Agent 提供优质资源。
什么是精彩列表? 精彩列表是社区精选的各类主题优质工具、库和资源合集,内容涵盖机器学习框架到设计工具等。添加此 MCP 服务后,你的 AI Agent 就能即时访问这些经过审核的高质量资源,而不必依赖随机的网络搜索。
适用于:
- 知识工作者 Agent,帮助他们找到与工作最相关的参考资料
- 获取优质学习资源
- 深入研究,可快速收集任意主题的大量高质量资源。
- 搜索 Agent
https://github.com/user-attachments/assets/babab991-e4ff-4433-bdb7-eb7032e9cd11
两种使用 Context Awesome 的方式
| 模式 | 安装方式 | 适用场景 |
|---|---|---|
| MCP 服务 | 让你的 Agent 连接托管 URL,或启动 context-awesome-mcp | Claude Desktop、Cursor、Windsurf、VS Code — 原生支持 MCP 的 Agent |
| CLI | npm install -g context-awesome | 脚本、Shell 工作流、不支持 MCP 的编辑器、CI 任务 |
两种模式都来自同一个 npm 包(context-awesome),并连接到同一托管后端。
MCP 工具
每个 MCP 工具都有对应的 CLI 子命令 — 服务端和 CLI 提供相同的操作。
| 工具 | 对应的 CLI 命令 | 功能 |
|---|---|---|
find_awesome_section | context-awesome sections <query...> | 查找精彩列表中与查询匹配的分类/类别 |
search_awesome_items | context-awesome search <query...> | 对各个条目(工具/库/资源)进行全文搜索 |
get_awesome_items | context-awesome items <target> | 从已知列表和分类中获取条目,并按 token 预算控制数量 |
CLI 命令
CLI(context-awesome)直接连接托管后端。使用 MCP 服务时,请使用单独的 context-awesome-mcp 二进制文件(见下文的 安装 — MCP 客户端)。
context-awesome <command> [options]
Commands:
sections <query...> Find sections matching a query
search <query...> Search items (e.g., context-awesome search "postgres orm")
items <target> Fetch items from a list (by owner/repo or listId)
Globals:
--api-host <url> Backend API host (env: CONTEXT_AWESOME_API_HOST)
--api-key <key> API key (env: CONTEXT_AWESOME_API_KEY)
--json Emit raw JSON (for scripts)
安装 CLI
npm install -g context-awesome
context-awesome --help
context-awesome search "rate limiter"
context-awesome sections "graph databases"
不安装即可使用 CLI
npx context-awesome search "vector database"
安装 — MCP 客户端
远程服务(推荐)
Context Awesome 提供托管的 MCP 服务。无需安装。
在 Cursor 中安装
前往:Settings → Cursor Settings → MCP → Add new global MCP server
{
"mcpServers": {
"context-awesome": {
"url": "https://www.context-awesome.com/api/mcp"
}
}
}
在 Claude Code 中安装
claude mcp add --transport http context-awesome https://www.context-awesome.com/api/mcp
在 Claude Desktop 中安装
Settings → Connectors → Add Custom Connector。
- 名称:
Context Awesome - URL:
https://www.context-awesome.com/api/mcp
在 Windsurf / VS Code / Zed / JetBrains / LM Studio / ... 中安装
在每个客户端的“添加远程 MCP”界面中使用相同的 URL(https://www.context-awesome.com/api/mcp)。具体配置片段请参阅下方的相应章节。
本地 stdio(Claude Desktop,可离线使用)
{
"mcpServers": {
"context-awesome": {
"command": "npx",
"args": ["-y", "context-awesome-mcp", "serve", "--transport", "stdio"],
"env": {
"CONTEXT_AWESOME_API_HOST": "https://api.context-awesome.com"
}
}
}
}
本地 HTTP 传输(用于自定义集成)
npx context-awesome-mcp serve --transport http --port 3001
# then point your client at http://localhost:3001/mcp
本地开发
git clone https://github.com/bh-rat/context-awesome.git
cd context-awesome
npm install
npm run build
# CLI
./build/cli.js search "graph databases"
# MCP server (stdio)
./build/index.js --transport stdio
# MCP Inspector
npm run inspector
后端服务
此 MCP 服务和 CLI 连接到后端 API 服务,由它负责处理繁重的精选列表处理工作。
后端服务即将开源,届时社区可以为完整的 context-awesome 生态系统做出贡献并从中受益。
其他安装方式
在 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 中安装
- 点击汉堡菜单
- 选择 设置
- 前往 工具
- 点击 + 添加 MCP
- 输入 URL:
https://www.context-awesome.com/api/mcp - 名称:Context Awesome
在 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->Model Context Protocol (MCP) - 点击
+ Add - 配置 URL:
https://www.context-awesome.com/api/mcp - 点击
OK和Apply
在 Kiro 中安装
- 前往
Kiro>MCP Servers - 点击
+ Add - 配置 URL:
https://www.context-awesome.com/api/mcp - 点击
Save
在 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 - 点击
+ Add - 配置 URL:
https://www.context-awesome.com/api/mcp - 点击
Save
在 Copilot Coding Agent 中安装
{
"mcpServers": {
"context-awesome": {
"type": "http",
"url": "https://www.context-awesome.com/api/mcp",
"tools": ["find_awesome_section", "search_awesome_items", "get_awesome_items"]
}
}
}
在 LM Studio 中安装
- 前往
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 中安装
- 前往
Perplexity>Settings - 选择
Connectors - 点击
Add Connector - 选择
Advanced - 输入名称:
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 中安装
acli rovodev mcp
然后添加:
{
"mcpServers": {
"context-awesome": {
"url": "https://www.context-awesome.com/api/mcp"
}
}
}
在 Zencoder 中安装
- 前往 Zencoder 菜单(...)
- 选择 Agent 工具
- 点击添加自定义 MCP
- 名称:
Context Awesome - URL:
https://www.context-awesome.com/api/mcp
在 Qodo Gen 中安装
- 打开 Qodo Gen 聊天面板
- 点击连接更多工具
- 点击 + 添加新的 MCP
- 添加:
{
"mcpServers": {
"context-awesome": {
"url": "https://www.context-awesome.com/api/mcp"
}
}
}
许可证
MIT
参与贡献
欢迎贡献!请:
- Fork 此代码库
- 创建功能分支
- 为新功能添加测试
- 确保所有测试通过
- 提交拉取请求
支持
如有问题或疑问:
- GitHub Issues:https://github.com/bh-rat/context-awesome/issues
归属说明
此项目使用了 GitHub 上 8,500 多个精选列表的数据。完整的数据来源代码库列表请参阅 ATTRIBUTION.md。
致谢
使用以下项目构建:
- Model Context Protocol SDK
- Awesome Lists
- 受到 context7 MCP 服务模式的启发
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。