Servidor de herramientas web MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para operaciones web. Este servidor permite a los LLM interactuar con el contenido web mediante herramientas estandarizadas.

Herramientas actuales

web_scrape : Convierte una URL para usar r.jina.ai como prefijo y devuelve el contenido de Markdown

Related MCP server: Playwright MCP Server

Instalación

Clonar este repositorio:
git clone <repository-url> cd MCP
Instale las dependencias necesarias:
pip install -r requirements.txt
Alternativamente, puede utilizar uv para una instalación más rápida:
uv pip install -r requirements.txt

Ejecución del servidor y la interfaz de usuario

Este repositorio incluye scripts convenientes para ejecutar el servidor MCP o la interfaz de usuario Streamlit.

Uso de los scripts de ejecución

En macOS/Linux:

# Run the server with stdio transport (default) ./run.sh server # Run the server with SSE transport ./run.sh server --transport sse --host localhost --port 5000 # Run the Streamlit UI ./run.sh ui

En Windows:

# Run the server with stdio transport (default) run.bat server # Run the server with SSE transport run.bat server --transport sse --host localhost --port 5000 # Run the Streamlit UI run.bat ui

Ejecutar manualmente

Alternativamente, puede ejecutar el servidor directamente:

Usando stdio (predeterminado)

python server.py

Uso de SSE

python server.py --transport sse --host localhost --port 5000

Esto iniciará un servidor HTTP en localhost:5000 que acepta conexiones MCP.

Y para ejecutar la interfaz de usuario de Streamlit manualmente:

streamlit run streamlit_app.py

Pruebas con MCP Inspector

El Inspector MCP es una herramienta para probar y depurar servidores MCP. Puede usarlo para interactuar con su servidor:

Instalar el Inspector MCP:
npm install -g @modelcontextprotocol/inspector
Ejecute el Inspector con su servidor:
npx @modelcontextprotocol/inspector python server.py
Utilice la interfaz Inspector para probar la herramienta web_scrape proporcionando una URL como example.com y viendo el contenido de rebajas devuelto.

Integración con Claude para escritorio

Para utilizar este servidor con Claude for Desktop:

Asegúrese de tener instalado Claude for Desktop .
Abra el archivo de configuración de Claude for Desktop:
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Ventanas: %APPDATA%\Claude\claude_desktop_config.json
Agregue la siguiente configuración (ajuste la ruta según sea necesario):

{ "mcpServers": { "web-tools": { "command": "python", "args": [ "/absolute/path/to/MCP/server.py" ] } } }

Reinicie Claude para escritorio.
Ahora deberías ver la herramienta web_scrape disponible en la interfaz de Claude. Puedes pedirle a Claude que extraiga contenido de un sitio web y la usará.

Ejemplo de uso

Una vez integrado con Claude, podrás hacer preguntas como:

"¿Qué hay en la página de inicio de example.com?"
"¿Puedes obtener y resumir el contenido de mozilla.org?"
"Obtén el contenido de wikipedia.org/wiki/Model_Context_Protocol y explícamelo".

Claude utilizará la herramienta web_scrape para obtener el contenido y proporcionarlo en su respuesta.

Agregar más herramientas

Para agregar más herramientas a este servidor:

Cree un nuevo archivo Python en el directorio tools/ , por ejemplo, tools/new_tool.py .
Implemente la función de su herramienta, siguiendo un patrón similar al de las herramientas existentes.
Importe su herramienta en server.py y regístrela con el servidor MCP:

# Import your new tool from tools.new_tool import new_tool_function # Register the tool with the MCP server @mcp.tool() async def new_tool(param1: str, param2: int) -> str: """ Description of what your tool does. Args: param1: Description of param1 param2: Description of param2 Returns: Description of return value """ return await new_tool_function(param1, param2)

Reinicie el servidor para aplicar los cambios.

Interfaz de usuario optimizada

Este repositorio incluye una aplicación Streamlit que le permite conectarse y probar todos sus servidores MCP configurados en Claude for Desktop.

Ejecución de la interfaz de usuario de Streamlit

streamlit run streamlit_app.py

Esto iniciará el servidor Streamlit y abrirá un navegador web con la interfaz de usuario.

Características

Cargue y analice su archivo de configuración de Claude for Desktop
Ver todos los servidores MCP configurados
Conéctese a cualquier servidor y vea sus herramientas disponibles
Pruebe herramientas proporcionando parámetros de entrada y visualizando resultados
Ver recursos y sugerencias disponibles

Uso

Inicie la aplicación Streamlit
Ingrese la ruta a su archivo de configuración de Claude for Desktop (la ruta predeterminada está completa previamente)
Haga clic en "Cargar servidores" para ver todos los servidores MCP disponibles
Seleccione una pestaña de servidor y haga clic en "Conectar" para cargar sus herramientas
Seleccione una herramienta y proporcione los parámetros necesarios
Haga clic en "Ejecutar" para ejecutar la herramienta y ver los resultados.

Solución de problemas

Dependencias faltantes : asegúrese de que todas las dependencias en requirements.txt estén instaladas.
Problemas de conexión : verifique que el servidor esté ejecutándose y que la configuración en Claude for Desktop apunte a la ruta correcta.
Errores de ejecución de la herramienta : busque mensajes de error en la salida del servidor.
Problemas de interfaz de usuario de Streamlit : asegúrese de que Streamlit esté instalado correctamente y que la ruta del archivo de configuración sea correcta.