ailist-mcp

AiList MCP 服务

“在 AiList 上收录我的项目”——只需对你的 AI Agent 说这一句话，你的项目就能被数千名 AI 编码助手发现。

AiList MCP 将 Claude Code 连接到精选 AI 项目目录。搜索 MCP 服务、CLI 工具、库和 API，也可以直接在终端中提交你自己的项目。

快速设置

选项 1：npx（无需安装）

添加到你的 .mcp.json：

{
  "mcpServers": {
    "ailist": {
      "command": "npx",
      "args": ["-y", "ailist-mcp"]
    }
  }
}

选项 2：Claude Code CLI

claude mcp add ailist -- npx -y ailist-mcp

选项 3：使用 API 密钥（用于提交项目）

{
  "mcpServers": {
    "ailist": {
      "command": "npx",
      "args": ["-y", "ailist-mcp"],
      "env": {
        "AILIST_API_KEY": "your-api-key-here"
      }
    }
  }
}

在 hifriendbot.com/ai-list/submit/ 免费获取 API 密钥

你的 Agent 能做什么？

收录你的项目——告诉你的 Agent“在 AiList 上收录我的项目”，它就会读取你的代码仓库、填写详细信息并提交。自动审核通过后，你的项目几分钟内就会上线。

发现工具——你的 Agent 会搜索目录，找到适合当前任务的 MCP 服务、库或 CLI 工具。无需再四处浏览，直接询问即可。

了解热门趋势——查看本周哪些 AI 项目正在走红，并按星标增长速度排序。

环境变量

变量	必需	描述
AILIST_API_KEY	否	用于提交项目的 API 密钥。在 hifriendbot.com/ai-list/submit/ 免费获取
AILIST_API_URL	否	覆盖 API 基础 URL（默认为 hifriendbot.com）

搜索和浏览无需 API 密钥。 所有读取操作均免费且无需身份验证。

可用工具

search_projects

搜索和浏览 AI 项目。支持按类别筛选和排序。

search_projects(query: "mcp server", category: "mcp-server", sort: "stars")

参数：

• query（字符串，可选）——搜索查询
• category（字符串，可选）——筛选类别：mcp-server、cli-tool、library、web-app、api、plugin、model、dataset、agent、other
• built_with（字符串，可选）——按技术筛选（例如“Claude Code”“Cursor”）
• sort（字符串，默认值为 "stars"）——排序方式：stars、trending、newest、name、views
• page（整数，默认值为 1）——页码
• per_page（整数，默认值为 24，最大值为 100）——每页结果数

get_project

根据项目的 slug 获取完整详细信息。

get_project(slug: "cogmemai-mcp")

参数：

• slug（字符串，必需）——项目的 URL slug

list_categories

列出所有项目类别及其数量。

list_categories()

无参数。

get_trending

发现本周热门的 AI 项目，并按星标增长速度排序。

get_trending(limit: 10)

参数：

• limit（整数，默认值为 20，最大值为 50）——结果数量

get_stats

获取整个目录的统计数据。

get_stats()

无参数。返回项目总数、本周新增项目数和类别分布。

submit_project

将你的项目提交到目录。需要 AILIST_API_KEY。

submit_project(
  name: "My Tool",
  tagline: "Does something cool",
  url: "https://example.com",
  category: "cli-tool"
)

参数：

• name（字符串，必需）——项目名称
• tagline（字符串，可选）——简短描述
• description（字符串，可选）——完整描述（Markdown）
• url（字符串，可选）——主页 URL
• github_url（字符串，可选）——GitHub 代码仓库 URL
• npm_package（字符串，可选）——npm 包名称
• pypi_package（字符串，可选）——PyPI 包名称
• category（字符串，可选）——项目类别
• tags（字符串，可选）——以逗号分隔的标签
• built_with（字符串，可选）——所用技术
• creator_name（字符串，可选）——创建者名称
• creator_url（字符串，可选）——创建者 URL

示例

收录你的项目：

"Hey Claude, list my project on AiList"

你的 Agent 会读取代码仓库，并调用 submit_project 填入相应信息。

查找 MCP 服务：

search_projects(query: "memory", category: "mcp-server")

查看热门趋势：

get_trending(limit: 5)

按技术浏览：

search_projects(built_with: "Claude Code", sort: "stars")

关于 AiList

AiList 是一个精选 AI 项目目录。每个收录项目都有独立的 SEO 索引页面，REST API 完全公开，让人类和 AI Agent 都能发现你的项目。

许可证

MIT