Awesome列表搜索服务

一款用于搜索631+精选Awesome列表和其中177,000+工具/库的服务,提供全局项目搜索、语言过滤和GitHub元数据查询功能。

  • by arimxyer
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 arimxyer/ass

使用说明

出色的搜索服务

MCP服务器,用于搜索631多个精心策划的精彩列表和其中的177000多个工具/库。

特性

  • 搜索列表 -按关键字查找很棒的列表(例如,“机器学习”、“生锈”)
  • 全局项目搜索 -搜索所有17.7万个项目,而不仅仅是在一个列表中
  • 按语言筛选 -查找Python、Rust、Go项目等。
  • GitHub元数据 -星数、语言、最后更新时间
  • 快速CDN交付 -通过jsDelivr提供数据(~1s加载时间)

快速开始

克劳德代码

claude mcp add awess -- bunx awess@latest

克劳德桌面版

添加到您的配置文件中:

{
  "mcpServers": {
    "awess": {
      "command": "bunx",
      "args": ["awess"]
    }
  }
}

配置位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

直接运行

bunx awess@latest

使用MCP检查员进行测试

npx @modelcontextprotocol/inspector bunx awess@latest

工具

搜索列表

搜索精心策划的精彩列表。返回按相关性(如果提供了查询)或星号排序的列表。

参数:

  • query (可选):搜索查询(例如“rust”、“机器学习”)
  • repo (可选):精确的回购查询(例如,“sindresorhus/aswear”)
  • sortBy (可选):“相关性”|“星级”|“更新”(默认值:“星级”,如果提供查询,则为“相关性”)
  • minStars (可选):最小星数过滤器
  • limit (可选):最大结果(默认值:20)
  • offset (可选):跳过前N个结果(用于分页)

示例:

// Search for rust lists
{ "query": "rust", "limit": 5 }

// Get top lists by stars
{ "sortBy": "stars", "limit": 10 }

// Lookup specific list
{ "repo": "sindresorhus/awesome" }

// Recently updated lists
{ "sortBy": "updated", "minStars": 5000 }

搜索项目

在所有出色的列表中搜索工具、库和资源。支持在特定列表中进行全局搜索或筛选。

参数:

  • query (可选):搜索项目名称/描述
  • repo (可选):限制到一个特定的列表(例如,“vinta/asweet python”)
  • category (可选):按类别筛选
  • language (可选):按编程语言筛选
  • minStars (可选):GitHub最低星级
  • sortBy (可选):“相关性”|“星级”|“更新”(默认值:“星级”,如果提供查询,则为“相关性”)
  • limit (可选):最大结果(默认值:50)
  • offset (可选):跳过前N个结果(用于分页)

示例:

// Find all GraphQL libraries across all lists
{ "query": "graphql", "minStars": 1000 }

// Find Rust projects with 10k+ stars
{ "language": "rust", "minStars": 10000 }

// Browse items from a specific list
{ "repo": "vinta/awesome-python", "category": "Web Frameworks" }

// Top items by stars globally
{ "sortBy": "stars", "limit": 20 }

浏览_类别

列出带有项目计数的可用类别。

参数:

  • repo (可选):从特定列表中筛选到类别
  • limit (可选):最大类别(默认值:50)

示例:

// Get top categories across all lists
{ "limit": 20 }

// Categories from a specific list
{ "repo": "vinta/awesome-python" }

统计

获取关于精心策划的精彩列表集合和项目的统计数据。

参数: 无

退货:

{
  "lists": {
    "total": 631,
    "totalStars": 6671565,
    "avgStars": 10573,
    "starDistribution": { "10000+": 102, "5000-9999": 77, ... }
  },
  "items": {
    "totalItems": 177803,
    "enrichedItems": 84083,
    "listsWithItems": 626,
    "topLanguages": { "Python": 15193, "TypeScript": 6221, ... },
    "topCategories": { "Papers": 4923, "Tools": 3241, ... }
  }
}

发展

git clone https://github.com/arimxyer/ass.git
cd ass
bun install
bun run start

构建项目索引

GITHUB_TOKEN=xxx bun scripts/build-items.ts

从所有出色的列表中获取README,解析项目,丰富GitHub元数据,并写入 data/items.json.gz.

许可证

麻省理工学院