pshare-share-mcp

Servidor MCP que permite a cualquier IA (Claude Code, Claude Desktop u otro cliente MCP) subir archivos/carpetas a Pshare y recibir un enlace de compartir — igual que la operación manual: subir por la interfaz y pulsar el botón Share para copiar el enlace.

No requiere inicio de sesión ni token alguno — coherente con la arquitectura actual de Pshare (el propio cliente web tampoco se autentica de verdad, solo usa un X-Browser-Id autogenerado).

Requisito: tener ya una instancia de Pshare ejecutándose en algún lugar (localhost o en la LAN) — este repositorio es solo un servidor MCP que llama a la API REST de Pshare, no ejecuta Pshare por sí mismo.

Herramienta proporcionada

pshare_upload

Resultado devuelto: enlace compartido con formato http://<pshare-host>/?share=<N> junto con el número de archivos y el estado de la contraseña.

Los archivos de más de 90 MB se cambian automáticamente a subida fragmentada (igual que el comportamiento de subida LAN del cliente web), sin necesidad de preocuparse por nada más.

Related MCP server: vnsh-mcp

Instalación

Solo hay que clonar este repositorio — no es necesario descargar Pshare completo:

git clone https://github.com/ntanhprt/Pshare-mcp.git
cd Pshare-mcp
pnpm install
pnpm build      # biên dịch ra dist/

Configuración (variables de entorno)

localhost solo es correcto cuando el servidor MCP se ejecuta en la misma máquina que ejecuta Pshare. localhost siempre apunta a "la propia máquina que ejecuta ese proceso" — por lo tanto, si instalas este MCP en una máquina/portátil distinta de la que ejecuta Pshare (incluso en la misma LAN), es obligatorio cambiarlo por la IP real de la máquina que ejecuta Pshare. Por ejemplo, si Pshare se ejecuta en una máquina con IP 192.168.3.7:

PSHARE_BASE_URL=http://192.168.3.7:5173 claude mcp add pshare-share -- node "$(pwd)/dist/index.js"

Mantén el valor por defecto localhost solo cuando ejecutes MCP (stdio) directamente en la misma máquina que ejecuta Pshare.

Prueba independiente

# stdio (mặc định)
pnpm start

# HTTP/SSE — AI ở máy khác trong LAN cũng gọi được
pnpm start:http
# → nghe tại http://<PSHARE_MCP_HOST>:<PSHARE_MCP_PORT>/mcp

Guía de integración para otros desarrolladores

1. Uso con Claude Code (transporte stdio — recomendado cuando la IA se ejecuta en la misma máquina/host que Pshare)

Después de clonar y compilar (ver la sección Instalación arriba), desde dentro de la carpeta Pshare-mcp:

claude mcp add pshare-share -- node "$(pwd)/dist/index.js"

Para apuntar a Pshare en otra máquina, pasa las variables de entorno con -e (ver la nota sobre localhost en la sección Configuración):

claude mcp add pshare-share \
  -e PSHARE_BASE_URL=http://192.168.3.7:5173 \
  -- node "$(pwd)/dist/index.js"

Comprobar que se ha registrado:

claude mcp list

2. Uso con Claude Desktop (transporte stdio)

Abre el archivo de configuración (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en Windows) y añade:

{
  "mcpServers": {
    "pshare-share": {
      "command": "node",
      "args": ["/đường/dẫn/tuyệt/đối/tới/Pshare-mcp/dist/index.js"],
      "env": {
        "PSHARE_BASE_URL": "http://localhost:5173"
      }
    }
  }
}

Reinicia Claude Desktop para recibir la herramienta pshare_upload.

3. Uso a través de HTTP/SSE (cuando la IA se ejecuta en otra máquina de la misma LAN)

Ejecuta el servidor MCP en la máquina que aloja Pshare (o en cualquier máquina que pueda acceder a Pshare):

PSHARE_BASE_URL=http://localhost:5173 pnpm start:http

En la máquina cliente (Claude Code, o cualquier cliente MCP que admita transporte HTTP), apunta a:

http://<IP-máy-chạy-mcp>:7317/mcp

Ejemplo con Claude Code:

claude mcp add --transport http pshare-share http://192.168.3.7:7317/mcp

4. Uso con cualquier otro framework de IA/agente

MCP es un protocolo JSON-RPC estándar — cualquier cliente MCP (adaptador MCP de LangChain, agente personalizado, etc.) puede conectarse, solo necesita:

• stdio: ejecutar el comando node dist/index.js y comunicarse a través de stdin/stdout.

• HTTP: llamar a POST http://<host>:<port>/mcp según la especificación de transporte Streamable HTTP de MCP.

Notas de seguridad

Este servidor MCP no autentica — cualquiera que pueda acceder a él (a través de stdio si tiene permisos para ejecutar el proceso, o a través de HTTP si puede acceder al host:puerto) puede subir/compartir archivos al Pshare real. Esto es coherente con el propio Pshare (no tiene autenticación en la API de subida/compartición), pero hay que tenerlo en cuenta al exponer el transporte HTTP fuera de la LAN.