4PDA MCP Server

Удалённый MCP-сервер для поиска тем и чтения постов открытого форума 4PDA. Он использует современный Streamable HTTP: после деплоя клиент подключается к одному HTTPS-адресу, компьютер владельца не должен быть включён.

Инструменты

• search_4pda(query, pages=1) — поиск тем (от 1 до 5 страниц).
• parse_4pda_topic(url, pages=1) — посты из темы (от 1 до 5 страниц).

Ссылки в парсинге ограничены https://4pda.to/...showtopic=...; это не позволяет превратить сервер в прокси для внутренних адресов. Учитывайте правила 4PDA и не запускайте массовый сбор данных.

Развёртывание без собственного компьютера

1. Создайте пустой GitHub-репозиторий и загрузите в него файлы этой папки.
2. В Railway (или Render/Fly.io) создайте новый сервис из этого GitHub-репозитория. Dockerfile будет определён автоматически; не задавайте start command.
3. После сборки платформа выдаст публичный домен. MCP endpoint: https://ВАШ-ДОМЕН/mcp.
4. Добавьте этот URL в клиент ИИ, который поддерживает remote MCP / Streamable HTTP. Для публичного сервиса рекомендуются домен, HTTPS и авторизация на прокси (например, Cloudflare Access), иначе любой, кто узнает URL, сможет пользоваться парсером.

Контейнер слушает переменную PORT, которую задаёт хостинг. Никакой проброс портов и постоянно включённый ПК не требуются.

Прокси для 4PDA

4PDA может блокировать IP-адреса облачных дата-центров. Сервер поддерживает HTTP/SOCKS-совместимый прокси через секрет PROXY_URL; он не попадает в GitHub и не возвращается инструментами MCP.

Для бесплатной проверки подойдёт Webshare Free: на момент публикации сервис выдаёт 10 shared datacenter proxy и 1 GB в месяц без карты. В Render откройте Environment → Add Environment Variable и добавьте:

Key:   PROXY_URL
Value: http://USERNAME:PASSWORD@HOST:PORT

Возьмите HOST:PORT, имя и пароль из списка HTTP-прокси Webshare. Значение в Render является секретом: не добавляйте его в исходный код, README или сообщения. Shared/datacenter IP могут всё равно быть заблокированы 4PDA; если так случится, понадобится residential/ISP-прокси.

Локальный запуск и проверка

python -m pip install -r requirements.txt
python mcp_server.py

Endpoint будет доступен на http://localhost:8000/mcp.

Claude Desktop (только локальный режим)

{
  "mcpServers": {
    "4pda-parser": {
      "command": "python",
      "args": ["C:\\Users\\xmeta\\Desktop\\4pda_topic_packer\\mcp_server.py"]
    }
  }
}

Для удалённого сервера используйте в интерфейсе клиента именно URL https://ВАШ-ДОМЕН/mcp; поддержка подключения remote MCP зависит от конкретного ИИ-клиента.