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

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.

Licencia

Este proyecto está disponible bajo la licencia MIT. Consulte el archivo de licencia para más detalles.

MCP Web Tools Server

Integrations