cameronrye/gopher-mcp

Обходит кэшированную копию этого URL и заново получает её с сервера. Устанавливайте его в true, когда пользователь хочет узнать текущее состояние: 'проверь ещё раз', 'они уже выложили?', 'это выглядит устаревшим', или когда предыдущий результат вернулся с cached: true и cache_age_seconds, слишком большим, чтобы честно ответить на вопрос. Окно, полученное с параметром offset, тоже возвращает cached: true, поскольку оно сформировано из загрузки, выполненной первым окном, а не получено заново. cache_age_seconds показывает, сколько лет этим байтам, как и для любого другого кэшированного результата, и решение принимается только на основе возраста. Обновление в середине обхода отбрасывает все окна этого ресурса, а не только запрошенное, поэтому уже прочитанные окна при следующем чтении загружаются заново: лучше завершить обход и перечитать после этого. Оставляйте его в false при обычном просмотре и переходе по ссылкам: Gopher и Gemini в основном обслуживаются небольшими любительскими хостами, которых кэш избавляет от повторного трафика. В любом случае возвращённый ответ сохраняется для последующих чтений.

URL-адреса Gemini для получения, не более 50 за один вызов. Результаты возвращаются в том же порядке и в том же количестве, что и этот список.

Хост для отчёта, например astrobotany.mozz.us. Если опустить — будут перечислены все области, где есть идентичность пользователя, то есть фактически список капсул, на которых у этого пользователя есть аккаунт или псевдоним, поэтому укажите именно тот хост, о котором идёт речь, если только пользователь не хочет видеть всё хранилище целиком.

«create» создаёт новую учётную запись для области URL и сохраняет её; с этого момента каждый запрос в этой области несёт её с собой, так что капсула может связывать эти посещения друг с другом. Она никогда не заменяет существующий сертификат в области действия. «remove» уничтожает сертификат, покрывающий область, вместе с его закрытым ключом, который невозможно восстановить.

Требуется для 'remove' и отклоняется для 'create': SHA-256 отпечаток уничтожаемого сертификата, в hex с двоеточиями или без, и с необязательным префиксом 'sha256:'. Вызовите gemini_client_cert_list и скопируйте значение, которое он возвращает. Это блокировка, а не учёт: она не даёт удалить невосстановимый приватный ключ без указания, какая именно личность уничтожается.

URL-адрес gemini://, к которому относится идентификатор — для операции "create" это URL, который вернул статус 60, а для действия с сохранённым идентификатором — URL, который сообщает gemini_client_cert_list для него, передаётся без изменений. Сертификат покрывает этот путь и всё, что ниже него, и ничего больше, поэтому gemini://host/app/page.gmi покрывает одну страницу, а gemini://host/app/ покрывает весь раздел; передавайте форму с каталогом только тогда, когда пользователь имеет в виду весь раздел, потому что более широкий охват означает, что больше его действий в сети можно связать. URL без пути — gemini://host/ — самый широкий из всех: он создаёт один идентификатор для ВСЕЙ капсулы, поэтому каждый запрос к ней с этого момента можно связать с любым другим. Любая строка запроса игнорируется.

Необязательный ответ на входной запрос Gemini с уровнем статуса 10/11. Он закодирован в percent-encoding и отправляется как строка запроса, поэтому передавайте ответ как есть (пробелы, &, = и юникод обрабатываются автоматически). Заменяет любой существующий запрос в url.

С чего начать чтение, если ресурс вернулся усечённым. Передай next_offset из предыдущего результата - он считает пункты меню для Gopher-меню и символы для тела страницы - чтобы получить следующее окно; оставь его 0 (значение по умолчанию), чтобы читать с начала. Результат с truncated: true и next_offset - сигнал, что есть ещё: продолжай с него, а не выдавай частичную страницу за целую, и остановись, когда next_offset вернётся null. Продолжение обычно дешёвое - ресурс скачивается один раз, а последующие окна рендерятся из него - с двумя исключениями: каждое окно скачивается заново, когда кэширование выключено, а GEMINI-URL с query-строкой скачивается заново всегда, потому что ответ на запрос со статусом 10/11 уходит туда и нигде не хранится. Так что читай дальше, потому что контент нужен, а не по привычке.

Обходит кэшированную копию этого URL и заново получает её с сервера. Устанавливайте его в true, когда пользователь хочет узнать текущее состояние: 'проверь ещё раз', 'они уже выложили?', 'это выглядит устаревшим', или когда предыдущий результат вернулся с cached: true и cache_age_seconds, слишком большим, чтобы честно ответить на вопрос. Окно, полученное с параметром offset, тоже возвращает cached: true, поскольку оно сформировано из загрузки, выполненной первым окном, а не получено заново. cache_age_seconds показывает, сколько лет этим байтам, как и для любого другого кэшированного результата, и решение принимается только на основе возраста. Обновление в середине обхода отбрасывает все окна этого ресурса, а не только запрошенное, поэтому уже прочитанные окна при следующем чтении загружаются заново: лучше завершить обход и перечитать после этого. Оставляйте его в false при обычном просмотре и переходе по ссылкам: Gopher и Gemini в основном обслуживаются небольшими любительскими хостами, которых кэш избавляет от повторного трафика. В любом случае возвращённый ответ сохраняется для последующих чтений.

Полный URL вида gemini://, например gemini://geminiprotocol.net/. При ответе с кодом состояния 10/11 (запрос ввода) вызовите инструмент снова, передав ответ пользователя в аргументе input, а не собирая строку запроса вручную. В Geminispace нет нормального поисковика: kennedy.gemi.dev и tlgs.one стоит посмотреть, но оба запрещают путь /search в своих robots.txt, поэтому поисковый URL там возвращает BLOCKED_BY_ROBOTS.

Имя хоста для отчёта, например geminiprotocol.net. Опустите, чтобы вывести список всех закреплённых хостов — фактически это список капсул, которые посетил данный пользователь, поэтому укажите хост, о котором именно вы спрашиваете, если только пользователь не хочет получить весь список.

«remove» снимает пин, так что следующий запрос доверяет любому сертификату хоста и закрепляет его заново — это восстановление после переиздания, которое пользователь уже подтвердил как ожидаемое. «pin» заменяет пин на fingerprint напрямую, для случаев, когда у пользователя уже есть новый отпечаток от оператора или из другого доверенного канала.

SHA-256 отпечаток сертификата в hex-формате, с двоеточиями или без, и с необязательным префиксом 'sha256:'. Для "remove" это должно совпадать с отпечатком, закреплённым для данного хоста — вызовите gemini_trust_list и скопируйте значение, которое он сообщает. Это блокировка, а не учёт: она предотвращает удаление закрепления без указания, что именно удаляется. Для "pin" это НОВЫЙ отпечаток, которому нужно доверять, и он должен поступать от пользователя или оператора капсулы, никогда — от сервера, который закрепляется.

Единственное имя хоста, на которое нужно воздействовать. Никаких масок и никакого «все хосты»: каждая привязка изменяется осознанно, по имени.

Порт закреплённой записи. По умолчанию для Gemini это 1965.

Обходит кэшированную копию этого URL и заново получает её с сервера. Устанавливайте его в true, когда пользователь хочет узнать текущее состояние: 'проверь ещё раз', 'они уже выложили?', 'это выглядит устаревшим', или когда предыдущий результат вернулся с cached: true и cache_age_seconds, слишком большим, чтобы честно ответить на вопрос. Окно, полученное с параметром offset, тоже возвращает cached: true, поскольку оно сформировано из загрузки, выполненной первым окном, а не получено заново. cache_age_seconds показывает, сколько лет этим байтам, как и для любого другого кэшированного результата, и решение принимается только на основе возраста. Обновление в середине обхода отбрасывает все окна этого ресурса, а не только запрошенное, поэтому уже прочитанные окна при следующем чтении загружаются заново: лучше завершить обход и перечитать после этого. Оставляйте его в false при обычном просмотре и переходе по ссылкам: Gopher и Gemini в основном обслуживаются небольшими любительскими хостами, которых кэш избавляет от повторного трафика. В любом случае возвращённый ответ сохраняется для последующих чтений.

Gopher URL для получения, не более 50 за вызов. Результаты возвращаются в том же порядке и имеют ту же длину, что и этот список. Здесь нет аргумента search: поместите запрос типа 7 в сам URL или вызовите gopher_fetch, который процентно кодирует термины за вас.

С чего начать чтение, если ресурс вернулся усечённым. Передай next_offset из предыдущего результата - он считает пункты меню для Gopher-меню и символы для тела страницы - чтобы получить следующее окно; оставь его 0 (значение по умолчанию), чтобы читать с начала. Результат с truncated: true и next_offset - сигнал, что есть ещё: продолжай с него, а не выдавай частичную страницу за целую, и остановись, когда next_offset вернётся null. Продолжение обычно дешёвое - ресурс скачивается один раз, а последующие окна рендерятся из него - с двумя исключениями: каждое окно скачивается заново, когда кэширование выключено, а GEMINI-URL с query-строкой скачивается заново всегда, потому что ответ на запрос со статусом 10/11 уходит туда и нигде не хранится. Так что читай дальше, потому что контент нужен, а не по привычке.

Обходит кэшированную копию этого URL и заново получает её с сервера. Устанавливайте его в true, когда пользователь хочет узнать текущее состояние: 'проверь ещё раз', 'они уже выложили?', 'это выглядит устаревшим', или когда предыдущий результат вернулся с cached: true и cache_age_seconds, слишком большим, чтобы честно ответить на вопрос. Окно, полученное с параметром offset, тоже возвращает cached: true, поскольку оно сформировано из загрузки, выполненной первым окном, а не получено заново. cache_age_seconds показывает, сколько лет этим байтам, как и для любого другого кэшированного результата, и решение принимается только на основе возраста. Обновление в середине обхода отбрасывает все окна этого ресурса, а не только запрошенное, поэтому уже прочитанные окна при следующем чтении загружаются заново: лучше завершить обход и перечитать после этого. Оставляйте его в false при обычном просмотре и переходе по ссылкам: Gopher и Gemini в основном обслуживаются небольшими любительскими хостами, которых кэш избавляет от повторного трафика. В любом случае возвращённый ответ сохраняется для последующих чтений.

Поисковые термины для селектора типа 7 (Index-Search), например Veronica-2. Они кодируются в percent-encoding и отправляются как строка запроса, поэтому передавайте слова пользователя как есть: запрос, содержащий #, +, & или не-ASCII символы, будет обрезан или искажён при записи в URL вручную, и сервер тогда ответит на поиск, который не запрашивался. Заменяет любой запрос, уже имеющийся в url. Оставьте его неустановленным для всех остальных типов элементов: RFC 1436 предусматривает поле запроса только для типа 7, поэтому поиск, отправленный куда-либо ещё, отбрасывается.

Полный URL gopher://. Первый символ пути - тип элемента (1=меню, 0=текстовый файл, 7=поиск). Для навигации переходите по next_url из пунктов меню. Чтобы отправить запрос к поисковому серверу типа 7, укажите URL самого поискового селектора - gopher://gopher.floodgap.com/7/v2/vs - и передавайте условия поиска в search, а не как дополнительные сегменты пути. Строка запроса, вписанная в URL (gopher://gopher.floodgap.com/7/v2/vs?python), по-прежнему работает, но search корректно обрабатывает #, + и не-ASCII. Пример: gopher://gopher.floodgap.com/1/