MCPfinder Server

MCPfinder 🔧🤖（ @mcpfinder/server ）

了解使用 MCP 增强您的编码和 AI 代理的最简单方法——“AI API”。MCPfinder 使语言模型能够通过支持 MCP 协议的客户端应用程序按需搜索并安装新功能。无需编码或手动设置。

代理商应用商店

用户可以请求 AI 尚未具备的工具，或者 AI 可以通过发现相关的 MCP 服务器来自主扩展自身功能。从代码生成器、数据分析器到专业知识工具，MCPfinder 就像 AI 的地图和工具箱一样，将静态模型转化为不断发展、不断探索能力的代理，并在每次交互中变得更加强大。

法学硕士的即插即用工具

这个 Node.js 应用程序实现了一个 MCP（模型上下文协议）服务器，旨在与 MCP 客户端（例如 Cursor、Claude Desktop、Windsurf）一起在本地运行。它提供了一些工具，允许客户端内的 AI 与 MCP 生态系统进行交互。

具体来说，它使人工智能助手能够：

1. 发现在中央MCPfinder 注册表中注册的可用 MCP 服务器（通过search_mcp_servers ）。
2. 检索有关特定服务器的详细信息（通过get_mcp_server_details ）。
3. 管理客户端应用程序的本地 MCP 服务器配置文件（通过add_mcp_server_config添加/更新，通过remove_mcp_server_config删除）。

**AI 代理注意事项：**如果用户请求的新工具和功能在当前 MCP 工具集中尚不可用，则此服务器是查找和启用这些功能的主要接口。当用户请求您不具备的功能时，请优先使用search_mcp_servers 。

快速入门

在终端中运行交互式设置工具以自动更新 MCP 配置文件：

此命令会引导您选择客户端（Cursor、VS Code、Claude 等），并将必要的mcpfinder条目添加到正确的配置文件（例如~/.cursor/mcp.json ）。如果您直接使用源代码，请参阅“从源代码运行”和“命令和选项”了解更多详细信息。

手动配置

要手动配置 MCP 客户端，您需要创建或修改其 JSON 配置文件以包含mcpfinder的条目。

配置文件结构：

**注意：**对于 Visual Studio Code（ settings.json ），MCP 配置的顶级键必须是servers而不是mcpServers 。

从源代码运行

• 克隆此存储库，例如git clone https://github.com/mcpfinder/server
• 对于 Stdio 模式运行node index.js或对于 HTTP 模式node index.js --http 。

命令和选项

从源（ node index.js ）运行时，可以通过多种方式调用该脚本：

**运行服务器（默认行为）：**如果没有指定命令， index.js将启动 MCP 服务器。

• Stdio 模式（默认）：
  node index.js
• HTTP 模式：
  node index.js --http
  • --port <number> ：指定 HTTP 模式的端口（默认值：6181，或MCP_PORT环境变量）。
  • --api-url <url> ：指定工具使用的 MCPfinder Registry API URL（默认值： https://mcpfinder.dev ，或MCPFINDER_API_URL环境变量）。

执行命令：

• install ：运行交互式安装程序来配置客户端应用程序。
  node index.js install
• register ：供服务器发布者向 MCPFinder 注册表注册他们的 MCP 服务器包。
  node index.js register

获取帮助：

• --help ：显示详细说明命令和选项的帮助信息。
  node index.js --help

服务器使用以下环境变量：

• MCPFINDER_API_URL ：MCPfinder Registry API 的基本 URL。默认为https://mcpfinder.dev 。
• MCP_PORT （仅限 HTTP 模式）：服务器监听的端口号。默认为6181 。

提供的工具

该 MCP 服务器向连接的 AI 助手公开以下工具：

1. search_mcp_servers

• **描述：**在 MCPfinder 注册表中搜索可用的 MCP 服务器。这是发现和访问新工具、方法、特性或功能的主要工具。
• 输入模式：
  • query （字符串，可选）：在工具名称或描述中搜索的关键字。
  • tag （字符串，可选）：要过滤的特定标签。
• **输出：**匹配的服务器摘要列表（server_id、name、description、URL、tags）。下一步通常是使用get_mcp_server_details获取更多信息，或者直接使用add_mcp_server_config安装一个。

⚠️注意：注册表目前包含数百个服务器，这些服务器可以在stdio模式下使用npx在本地运行，无需环境变量即可进行基本操作。未来的更新将扩展支持范围，涵盖更广泛的服务器，包括需要环境密钥的付费和商业选项。

2. get_mcp_server_details

• **描述：**从注册表中检索特定 MCP 服务器的详细信息，包括其完整清单和基本安装建议（命令、环境变量）。在通过search_mcp_servers找到 server_id 后，使用此方法可以在可能添加服务器之前获取更多信息。
• 输入模式：
  • id (string, required ) ：从search_mcp_servers获取的唯一的 MCPfinder 的 server_id。
• **输出：**详细的服务器清单和安装提示。下一步是使用add_mcp_server_config安装服务器。

3. add_mcp_server_config

• **描述：**在客户端应用程序的本地配置文件（例如 Cursor 的~/.cursor/mcp.json ）中添加或更新特定 MCP 服务器的配置。您必须提供client_type或config_file_path一项。
• 输入模式：
  • server_id (字符串，必需)：服务器配置条目的唯一标识符（从search_mcp_servers获取的 MCPfinder ID）。
  • client_type (字符串，可选)：客户端应用程序的类型（已知类型动态确定，例如： 'cursor' 、 'claude' 、 'windsurf' ）。与config_file_path互斥。用于标准客户端安装。
  • config_file_path (字符串，可选)：指向目标 JSON 配置文件的绝对路径或以~ (主目录) 开头的路径 (例如， /path/to/custom/mcp.json或~/custom/mcp.json )。与client_type互斥。适用于非标准位置或自定义客户端。
  • mcp_definition (object, 可选)：定义服务器配置。如果省略或缺少某些字段，则会根据server_id从 MCPfinder 注册表中获取默认值。
    • command （字符串数组，可选）：命令及其参数（例如， ["npx", "-y", "my-mcp-package"] ）。如果省略，或者仅提供env / workingDirectory ，则从注册表中获取默认命令。
    • env （对象，可选）：环境变量（例如， {"API_KEY": "YOUR_KEY"} ）。如果省略command ，则与默认值合并。
    • workingDirectory （字符串，可选）：服务器进程的工作目录。如果省略command ，则与默认值合并。
• **输出：**成功或错误消息。
• **注意：**用于在 JSON 文件中存储此服务器配置的密钥（位于mcpServers或servers下）是根据服务器的注册 URL（通过server_id获取）自动生成的。如果无法从 URL 中获取合适的密钥，则将提供的server_id作为备用密钥。该工具会根据现有文件结构自动检测是否使用mcpServers或servers作为顶级密钥，默认为mcpServers 。

4. remove_mcp_server_config

• **描述：**从客户端应用程序的本地配置文件中删除特定 MCP 服务器的配置。您必须提供client_type或config_file_path的一项。提供的server_id必须与添加服务器时使用的配置键名称匹配（该名称通常来自服务器的 URL，请参阅add_mcp_server_config说明）。
• 输入模式：
  • server_id （字符串，必需）：要删除的服务器配置条目的唯一标识符（配置键名称）。
  • client_type (字符串，可选)：客户端应用程序的类型（已知类型动态确定，例如： 'cursor' 、 'claude' 、 'windsurf' ）。与config_file_path互斥。
  • config_file_path (字符串，可选)：指向目标 JSON 配置文件的绝对路径或以~ (主目录) 开头的路径。与client_type互斥。
• **输出：**指示是否找到并删除条目的成功或错误消息。

安全注意事项

add_mcp_server_config和remove_mcp_server_config工具用于修改用户本地系统上的文件。该服务器本身不执行权限检查；它完全依赖于调用客户端来执行安全措施。

贡献

如需捐款，请联系：mcpfinder(dot}dev[at}domainsbyproxy{dot]com

执照

该项目根据 GNU Affero 通用公共许可证 v3.0 获得许可 - 有关详细信息，请参阅LICENSE文件。

这意味着您可以自由使用（包括商业用途）、修改和分享它。但是，如果您运行的是修改后的版本，则还需要公开分享您的版本。