MCPfinder Server

Buscador de MCP 🔧🤖 ( @mcpfinder/server )

Descubra la forma más sencilla de potenciar sus agentes de codificación e IA con MCP: una API para IA. MCPfinder permite que los modelos de lenguaje busquen e instalen nuevas capacidades bajo demanda a través de aplicaciones cliente compatibles con el protocolo MCP. No requiere codificación ni configuración manual.

App Store para agentes

Los usuarios pueden solicitar herramientas que la IA aún no posee, o bien, la IA puede expandir sus propias capacidades de forma autónoma al descubrir servidores MCP relevantes. Desde generadores de código y analizadores de datos hasta herramientas de conocimiento especializadas, MCPfinder actúa como un mapa y una caja de herramientas para la IA, transformando modelos estáticos en agentes en constante evolución que buscan nuevas capacidades y se vuelven más potentes con cada interacción.

Herramientas plug-and-play para LLM

Esta aplicación Node.js implementa un servidor MCP (Protocolo de Contexto de Modelo) diseñado para ejecutarse localmente junto con clientes MCP (como Cursor, Claude Desktop y Windsurf). Proporciona herramientas que permiten que la IA del cliente interactúe con el ecosistema MCP.

En concreto, permite al asistente de IA:

1. Descubra los servidores MCP disponibles registrados en el registro central MCPfinder (a través de search_mcp_servers ).
2. Recupere detalles sobre servidores específicos (a través de get_mcp_server_details ).
3. Administre el archivo de configuración del servidor MCP local de la aplicación cliente (agregar/actualizar mediante add_mcp_server_config , eliminar mediante remove_mcp_server_config ).

Nota para los agentes de IA: Este servidor es la interfaz principal para encontrar y habilitar nuevas herramientas y capacidades solicitadas por el usuario si aún no están disponibles en el conjunto de herramientas MCP actual. Utilice primero search_mcp_servers cuando el usuario le solicite una capacidad que no posee.

Inicio rápido

Ejecute en su terminal la herramienta de configuración interactiva para actualizar automáticamente el archivo de configuración de MCP:

Este comando le guía en la selección de su cliente (Cursor, VS Code, Claude, etc.) y añade la entrada necesaria mcpfinder al archivo de configuración correcto (p. ej., ~/.cursor/mcp.json ). Consulte "Ejecutar desde el código fuente" y "Comandos y opciones" para obtener más información si trabaja directamente con el código fuente.

Configuración manual

Para configurar manualmente un cliente MCP, debe crear o modificar su archivo de configuración JSON para incluir una entrada para mcpfinder .

Estructura del archivo de configuración:

Nota: Para Visual Studio Code ( settings.json ), la clave de nivel superior para las configuraciones de MCP debe ser servers en lugar de mcpServers .

Corriendo desde la fuente

• Clonar este repositorio, por ejemplo, git clone https://github.com/mcpfinder/server
• Ejecute node index.js para el modo Stdio o node index.js --http para el modo HTTP.

Comandos y opciones

Al ejecutarse desde la fuente ( node index.js ), el script se puede invocar de varias maneras:

Ejecución del servidor (comportamiento predeterminado): si no se especifica ningún comando, index.js inicia el servidor MCP.

• Modo Stdio (predeterminado):
  node index.js
• Modo HTTP:
  node index.js --http
  • --port <number> : especifica el puerto para el modo HTTP (predeterminado: 6181 o variable de entorno MCP_PORT ).
  • --api-url <url> : especifica la URL de la API de registro de MCPfinder utilizada por las herramientas (predeterminado: https://mcpfinder.dev o la variable de entorno MCPFINDER_API_URL ).

Ejecución de comandos:

• install : ejecuta la configuración interactiva para configurar una aplicación cliente.
  node index.js install
• register : para que los editores de servidores registren su paquete de servidor MCP con el registro MCPFinder.
  node index.js register

Obtener ayuda:

• --help : Muestra el mensaje de ayuda detallando comandos y opciones.
  node index.js --help

El servidor utiliza las siguientes variables de entorno:

• MCPFINDER_API_URL : URL base de la API de registro de MCPfinder. Su valor predeterminado es https://mcpfinder.dev .
• MCP_PORT (solo modo HTTP): El número de puerto donde el servidor escuchará. El valor predeterminado es 6181 .

Herramientas proporcionadas

Este servidor MCP expone las siguientes herramientas al asistente de IA conectado:

1. search_mcp_servers

• Descripción: Busca servidores MCP disponibles en el Registro de MCPfinder. Esta es la herramienta principal para descubrir y acceder a nuevas herramientas, métodos, funciones o capacidades.
• Esquema de entrada:
  • query (cadena, opcional): palabras clave para buscar en el nombre o la descripción de la herramienta.
  • tag (cadena, opcional): etiqueta específica por la que filtrar.
• Salida: Una lista de resúmenes de servidor coincidentes (server_id, nombre, descripción, URL, etiquetas). El siguiente paso habitual es usar get_mcp_server_details para obtener más información o directamente add_mcp_server_config para instalar uno.

⚠️ Nota: El registro contiene actualmente cientos de servidores que pueden ejecutarse localmente con npx en modo stdio sin requerir variables de entorno para su funcionamiento básico. En futuras actualizaciones, se ampliará la compatibilidad para incluir una gama más amplia de servidores, incluyendo opciones de pago y comerciales que requieren claves de entorno.

2. get_mcp_server_details

• Descripción: Obtiene información detallada sobre un servidor MCP específico del registro, incluyendo su manifiesto completo y sugerencias básicas de instalación (comandos, variables de entorno). Úselo después de encontrar un server_id mediante search_mcp_servers para obtener más información antes de añadirlo.
• Esquema de entrada:
  • id (cadena, obligatoria ): el server_id único de MCPfinder obtenido de search_mcp_servers .
• Salida: El manifiesto detallado del servidor y las sugerencias de instalación. El siguiente paso es usar add_mcp_server_config para instalar el servidor.

3. add_mcp_server_config

• Descripción: Agrega o actualiza la configuración de un servidor MCP específico en el archivo de configuración local de la aplicación cliente client_type p. ej., ~/.cursor/mcp.json de Cursor). Debe proporcionar client_type o config_file_path .
• Esquema de entrada:
  • server_id (cadena, obligatoria ): un identificador único para la entrada de configuración del servidor (el ID de MCPfinder obtenido de search_mcp_servers ).
  • client_type (cadena, opcional): El tipo de aplicación cliente (los tipos conocidos se determinan dinámicamente, por ejemplo: 'cursor' , 'claude' , 'windsurf' ). Se excluye mutuamente con config_file_path . Úselo para instalaciones de cliente estándar.
  • config_file_path (cadena, opcional): Una ruta absoluta o una ruta que empieza por ~ (directorio principal) al archivo de configuración JSON de destino (p. ej., /path/to/custom/mcp.json o ~/custom/mcp.json ). Se excluye mutuamente con client_type . Úselo para ubicaciones no estándar o clientes personalizados.
  • mcp_definition (objeto, opcional): Define la configuración del servidor. Si se omite o faltan algunos campos, se obtendrán los valores predeterminados del Registro de MCPfinder según el server_id .
    • command (matriz de cadenas, opcional): El comando y sus argumentos (p. ej., ["npx", "-y", "my-mcp-package"] ). Si se omite, o si solo se proporciona env / workingDirectory a continuación, el comando predeterminado se obtiene del registro.
    • env (objeto, opcional): Variables de entorno (p. ej., {"API_KEY": "YOUR_KEY"} ). Se fusiona con los valores predeterminados si se omite command .
    • workingDirectory (cadena, opcional): El directorio de trabajo del proceso del servidor. Se fusiona con los valores predeterminados si se omite command .
• Salida: Un mensaje de éxito o error.
• Nota: La clave utilizada para almacenar la configuración de este servidor en el archivo JSON (en mcpServers o servers ) se genera automáticamente a partir de la URL registrada del servidor (obtenida mediante server_id ). El server_id proporcionado se utiliza como alternativa si no se puede obtener una clave adecuada de la URL. La herramienta detecta automáticamente si se debe usar mcpServers o servers como clave de nivel superior según la estructura de archivos existente, y el valor predeterminado es mcpServers .

4. remove_mcp_server_config

• Descripción: Elimina la configuración de un servidor MCP específico del archivo de configuración local de la aplicación cliente. Debe proporcionar client_type o config_file_path . El server_id proporcionado debe coincidir con el nombre de la clave de configuración utilizada al agregar el servidor (que normalmente se deriva de la URL del servidor; consulte la nota client_type``add_mcp_server_config ).
• Esquema de entrada:
  • server_id (cadena, obligatoria ): el identificador único (nombre de la clave de configuración) de la entrada de configuración del servidor que se eliminará.
  • client_type (cadena, opcional): El tipo de aplicación cliente (los tipos conocidos se determinan dinámicamente, por ejemplo: 'cursor' , 'claude' , 'windsurf' ). Se excluye mutuamente con config_file_path .
  • config_file_path (cadena, opcional): Ruta absoluta o ruta que empieza por ~ (directorio de inicio) al archivo de configuración JSON de destino. Mutuamente excluyente con client_type .
• Salida: Un mensaje de éxito o error que indica si se encontró y eliminó la entrada.

Consideraciones de seguridad

Las herramientas add_mcp_server_config y remove_mcp_server_config modifican archivos en el sistema local del usuario. Este servidor no realiza comprobaciones de permisos; depende completamente del cliente que realiza la llamada para la aplicación de la seguridad.

Contribuyendo

Para contribuciones, comuníquese con: mcpfinder(punto}dev[at}domainsbyproxy{punto]com

Licencia

Este proyecto está licenciado bajo la Licencia Pública General Affero GNU v3.0 - consulte el archivo LICENCIA para obtener más detalles.

Significa que puedes usarlo (incluso con fines comerciales), modificarlo y compartirlo libremente. Sin embargo, si ejecutas una versión modificada, también estás obligado a compartirla públicamente.