pshare-share-mcp

MCP-сервер, позволяющий любому ИИ (Claude Code, Claude Desktop или другому MCP-клиенту) загружать файлы/папки на Pshare и получать ссылку для обмена — точно так же, как при ручном действии: загрузка через UI, затем нажатие кнопки Share для копирования ссылки.

Никакой авторизации/токенов не требуется — это согласуется с текущей архитектурой Pshare (сам веб-клиент тоже не выполняет реальную аутентификацию, используя лишь автоматически генерируемый X-Browser-Id).

Требование: уже должен быть запущен экземпляр Pshare где-либо (localhost или в LAN) — этот репозиторий является лишь MCP-сервером, вызывающим REST API Pshare, и не запускает Pshare самостоятельно.

Предоставляемые инструменты

pshare_upload

Результат: ссылка обмена вида http://<pshare-host>/?share=<N> с количеством файлов и статусом пароля.

Файлы > 90 МБ автоматически переключаются на чанковую загрузку (как при LAN-загрузке веб-клиента), дополнительных действий не требуется.

Related MCP server: vnsh-mcp

Установка

Достаточно клонировать этот репозиторий — скачивать весь Pshare не нужно:

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

Конфигурация (переменные окружения)

localhost корректен только если MCP-сервер запущен на той же машине, где работает Pshare. localhost всегда указывает на «саму машину, где запущен процесс» — поэтому если вы устанавливаете этот MCP на другой машине/ноутбуке (даже в той же LAN), чем машина с Pshare, обязательно замените его на реальный IP машины с Pshare. Например, если Pshare работает на машине с IP 192.168.3.7:

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

Оставляйте значение localhost по умолчанию только если вы запускаете MCP (stdio) прямо на той же машине, где работает Pshare.

Автономный пробный запуск

# 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

Руководство по интеграции для других разработчиков

1. Использование с Claude Code (транспорт stdio — рекомендуется, когда ИИ работает на той же машине/хосте, что и Pshare)

После клонирования и сборки (см. раздел «Установка» выше), из каталога Pshare-mcp:

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

Чтобы указать Pshare на другой машине, передайте env через -e (см. примечание о localhost в разделе «Конфигурация»):

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

Проверка регистрации:

claude mcp list

2. Использование с Claude Desktop (транспорт stdio)

Откройте файл конфигурации (~/Library/Application Support/Claude/claude_desktop_config.json на macOS, %APPDATA%\Claude\claude_desktop_config.json на Windows) и добавьте:

{
  "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"
      }
    }
  }
}

Перезапустите Claude Desktop, чтобы получить инструмент pshare_upload.

3. Использование через HTTP/SSE (когда ИИ работает на другой машине в той же LAN)

Запустите MCP-сервер на машине, где размещён Pshare (или на любой машине, которая может обращаться к Pshare):

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

На клиентской машине (Claude Code или любой MCP-клиент, поддерживающий HTTP-транспорт) укажите:

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

Пример с Claude Code:

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

4. Использование с любым другим ИИ/агентным фреймворком

MCP — это стандартный протокол JSON-RPC — любой MCP-клиент (LangChain MCP adapter, custom agent и т.д.) может подключиться, достаточно:

• stdio: запустить команду node dist/index.js и общаться через stdin/stdout.

• HTTP: вызывать POST http://<host>:<port>/mcp согласно спецификации Streamable HTTP transport от MCP.

Замечания по безопасности

Этот MCP-сервер не выполняет аутентификацию — любой, кто может к нему обратиться (через stdio при наличии прав на запуск процесса, или через HTTP при доступе к host:port), может загружать/делиться файлами на реальном Pshare. Это согласуется с самим Pshare (нет аутентификации в API загрузки/обмена), но следует учитывать при открытии HTTP-транспорта наружу в LAN.