MCPfinder 服务器使用说明

项目简介

MCPfinder 是一个旨在成为AI代理“能力商店”的平台。这个GitHub仓库包含的是MCPfinder的服务器端实现，它扮演着AI客户端（如Cursor、Claude桌面版等）与MCPfinder注册中心之间的桥梁。其核心功能是允许AI代理动态地搜索、检索详情并配置新的MCP服务器（即新的能力或工具）。

主要功能点

本MCP服务器向连接的AI客户端提供了以下四个核心工具：

查找 MCP 服务器 ('search_mcp_servers'): 让AI代理搜索MCPfinder注册中心，发现各种可用的工具、功能或能力。这是AI在缺乏某个特定能力时查找解决方案的主要方式。
获取 MCP 服务器详情 ('get_mcp_server_details'): 根据ID获取某个特定MCP服务器的详细信息，包括其提供的工具列表、描述以及可能的安装建议。
添加 MCP 服务器配置 ('add_mcp_server_config'): 允许AI代理将发现并选定的MCP服务器添加到其客户端的本地配置中，从而启用该服务器提供的能力。
移除 MCP 服务器配置 ('remove_mcp_server_config'): 允许AI代理从客户端的本地配置中移除不再需要的MCP服务器。

安装步骤

最简单的安装方法是使用提供的交互式设置工具：

在您的终端中运行：

npx -y @mcpfinder/server --setup

该命令会引导您选择正在使用的MCP客户端，并自动将MCPfinder服务器添加到客户端的MCP配置文件中。

如果您需要手动配置，请参考下一节。

服务器配置（为MCP客户端配置）

为了让您的MCP客户端（如Cursor, Claude桌面版, VS Code等）能够使用MCPfinder服务器，您需要在客户端的MCP配置文件（通常是JSON格式，如'~/.cursor/mcp.json'或VS Code的'settings.json'）中添加一个配置项。

这个配置项的名称应设为 'mcpfinder'。

在该配置项下，您需要指定如何启动MCPfinder服务器进程：

'command': 设置为 'npx'。这是Node.js包运行器的命令。
'args': 设置为一个包含启动参数的字符串数组。对于MCPfinder服务器，这个数组应包含 '"-y"' 和 '"@mcpfinder/server"'。'"-y"' 参数用于自动确认安装，'"@mcpfinder/server"' 是MCPfinder服务器的包名。

配置示例（JSON文件内容的一部分）：

{
  "mcpServers": { // 或 "servers" (取决于客户端，如VS Code)
    "mcpfinder": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpfinder/server"
      ]
    },
    // ... 其他 MCP 服务器配置 ...
  }
}

请将上述结构添加到您的客户端MCP配置文件中。

基本使用方法

配置完成后，MCPfinder服务器会在客户端需要时自动启动（通常是当AI代理尝试调用其提供的工具时）。

AI代理现在可以使用 'search_mcp_servers' 工具来发现新的能力。例如，如果用户要求AI执行一个AI当前不具备的功能（如联网搜索、文件操作、代码生成等），AI代理应优先调用 'search_mcp_servers' 工具，提供相关关键词进行搜索。然后，AI可以使用 'get_mcp_server_details' 查看详情，并使用 'add_mcp_server_config' 将找到的合适服务器添加到客户端配置中。一旦新的服务器被配置并启动，AI就可以直接调用该新服务器提供的工具了。

简而言之，MCPfinder服务器是AI代理获取新工具能力的入口。

关键词