使用说明

项目简介

本项目 'ai-agent-marketplace-index-mcp' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 提供访问 AI Agent Marketplace Index 的能力。通过此服务器，LLM 可以搜索和发现各种可用的 AI Agent，从而扩展其功能和应用场景。

主要功能点

AI Agent 搜索: 通过关键词或类别搜索 AI Agent Marketplace Index，查找满足特定需求的 AI Agent。例如，可以搜索“AI 编码助手”、“GUI AI Agent”等。
工具集成: 提供 'search_ai_agent' 工具，允许 LLM 通过发送 MCP 请求调用服务器的搜索功能。
信息检索: 返回 AI Agent 的详细信息，包括名称、描述、网站、所属领域和子领域，以及网站流量统计等指标。

安装步骤

克隆仓库: 将 GitHub 仓库 'ai-agent-marketplace-index-mcp' 克隆到本地。

安装依赖: 使用以下命令安装项目依赖：

uv venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate  # Windows
uv pip install -e .

服务器配置

为了让 MCP 客户端（例如 Claude Desktop 或 Cursor）连接到此服务器，您需要在客户端的配置文件中添加服务器信息。以 Claude Desktop 为例，您需要编辑 'claude_desktop_config.json' 文件，并添加如下配置：

{
    "mcpServers": {
        "ai-agent-marketplace-index-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "服务器程序所在的目录",  // 请替换为 ai-agent-marketplace-index-mcp/src/ai-agent-marketplace-index 目录的绝对路径
                "run",
                "server.py"
            ]
        }
    }
}

配置说明:

'"server name"': 'ai-agent-marketplace-index-mcp' - 服务器名称，客户端通过此名称识别服务器。
'"command"': '"uv"' - 用于启动服务器的命令，这里使用 'uv' 运行器。
'"args"': 启动参数列表。
- '"服务器程序所在的目录"': 重要: 请将此占位符替换为 'ai-agent-marketplace-index-mcp/src/ai-agent-marketplace-index' 目录在您本地文件系统中的绝对路径。例如，如果您的仓库克隆在 '/Users/yourname/repos/ai-agent-marketplace-index-mcp'，则此路径应为 '/Users/yourname/repos/ai-agent-marketplace-index-mcp/src/ai-agent-marketplace-index'。
- '"run"': 'uv run' 命令的子命令，表示运行 Python 模块或脚本。
- '"server.py"': 指定要运行的服务器脚本文件。

请务必将 '"服务器程序所在的目录"' 替换为正确的绝对路径，否则客户端将无法找到并启动服务器。

基本使用方法

启动服务器: 配置完成后，启动 Claude Desktop 或其他 MCP 客户端。客户端会自动尝试连接配置的 MCP 服务器。您也可以手动运行服务器：

uv run -m ai-agent-marketplace-index-mcp

或在开发模式下运行：

cd ./ai-agent-marketplace-index-mcp/src/ai-agent-marketplace-index
mcp dev server.py

LLM 调用工具: 在 LLM 的提示词中，指示 LLM 使用 'search_ai_agent' 工具来搜索 AI Agent。例如：
- "请帮我找一些可以用于儿童编程的 AI 编码助手。"
- "我想报税，请帮我查找可以完成这项任务的 AI Agent。"
获取搜索结果: 服务器会将搜索结果以文本形式返回给 LLM，包含 AI Agent 的名称、网站、描述、领域、子领域以及相关的统计信息（如网站排名、Github Star 数等）。

通过使用 'ai-agent-marketplace-index-mcp' 服务器，LLM 可以便捷地访问 AI Agent Marketplace Index，发现并利用各种 AI Agent 来增强自身的能力，完成更复杂的任务。

关键词