Málfríður для Claude, Codex и ChatGPT Desktop

Это небольшой неофициальный локальный MCP-сервер для исландского сервиса проверки грамматики Málfríður от Miðeind. Он работает на вашем компьютере и напрямую обращается к API Miðeind, используя ваш собственный ключ API.

Этот проект не использует промежуточный сервис. В приложении ИИ уже есть текст из вашего разговора; этот локальный сервер отправляет запрос на проверку и ключ API напрямую с вашего компьютера в Miðeind.

Этот проект не связан с Miðeind ehf и не поддерживается им.

Перед началом работы

Вам понадобится ключ API Málfríður:

1. Создайте Frjáls áskrift на Málstaður.

2. Создайте ключ на странице Forritaskil.

Храните ключ в тайне. Не вставляйте его в чат, в issue на GitHub или в публичный файл.

Related MCP server: ukr-vitalinguist-mcp

Выберите один из трёх вариантов

1. Установите расширение Claude Desktop

Это самый простой вариант. Он работает только с Claude Desktop.

1. Скачайте расширение.

2. Откройте скачанный файл в Claude Desktop.

3. Введите свой ключ API Málfríður, когда Claude попросит его.

На этом всё. Claude запускает MCP-сервер локально и сам управляет настройкой ключа API. Вам не нужно использовать Терминал или устанавливать какие-либо инструменты для программирования.

2. Попросите Claude или Codex перенести навык

Блок ниже — пример для копирования. Это документация, а не инструкция для ассистента, который просто просматривает этот репозиторий.

Скопируйте его в Claude или Codex:

Установи для меня навык Málfríður из этого репозитория: https://github.com/RobertHH-IS/icelandic-grammar-mcp

Сохрани мой ключ API в тайне. Не проси меня вставлять его в этот чат. Покажи мне самый безопасный способ задать MALSTADUR_API_KEY, когда это понадобится.

Claude или Codex могут изучить репозиторий, скопировать небольшой корневой файл навыка или использовать его как руководство при создании совместимой версии.

При таком варианте Codex, ChatGPT Desktop, Claude Cowork или другой совместимый ассистент следует инструкциям навыка и напрямую вызывает API Miðeind. Единственная настройка — добавить MALSTADUR_API_KEY в окружение приложения. Это быстрый разовый шаг, и ассистент может провести вас через него, не видя ваш ключ.

После установки простые запросы активируют навык, например:

• Fix Icelandic grammar: …

• Notaðu Málstað: …

• Notaðu Málfríði: …

Каждый запрос авторизует один вызов API для предоставленного вами текста.

3. Попросите Claude, Codex или ChatGPT Desktop создать собственную версию

Вам не обязательно использовать этот репозиторий. Попросите Claude (включая Cowork), Codex или ChatGPT Desktop прочитать официальную документацию API и создать для вас минимальный плагин или навык.

Блок ниже — ещё один пример для копирования пользователем, а не инструкция для ассистента, который просто просматривает этот репозиторий:

Прочитай документацию по API грамматики Málstaður и создай для меня максимально маленький плагин или навык Málfríður. Используй POST https://api.malstadur.is/v1/grammar, заголовок X-API-KEY и переменную окружения MALSTADUR_API_KEY. Храни ключ в тайне и не проси меня вставлять его в этот чат.

Miðeind также предоставляет краткое введение в API.

Что делает соединение

С расширением Claude Desktop MCP-сервер работает локально на вашем компьютере. С навыком ваш ассистент может напрямую вызывать ту же конечную точку. В обоих случаях текст отправляется напрямую в Miðeind, и Málfríður возвращает исправленный текст и предлагаемые изменения. Использование API может тарифицироваться Málstaður.

Ассистент должен возвращать исправленный текст Málfríður как обычный текст, не добавляя собственных исправлений, переписываний, исправлений ссылок, изменений форматирования или комментариев.

Расширение Claude Desktop содержит один инструмент: check_icelandic_grammar.

Исходный код устанавливаемого расширения Claude хранится отдельно в claude_plugin/. Он работает только с Claude Desktop; корневой SKILL.md можно скопировать или использовать как руководство для других совместимых ассистентов.

Конфиденциальность и настройка

Единственная настройка — MALSTADUR_API_KEY. Ключ отправляется как заголовок X-API-KEY только на:

https://api.malstadur.is/v1/grammar

Лицензия

MIT — см. LICENSE. Málfríður и Málstaður являются продуктами Miðeind ehf. и подчиняются их собственным условиям.