cooklang-mcp-server

Небольшой сервер на базе FasMCP, коорый преос авляе сервер рецеп ов CookCLI (cook server, поставляеся в ghcr.io/cooklang/cookcli) в виде MCP-инс румен ов для аген а программирования. С его помощью аген може просма рива ь, чи а ь, записыва ь, удаля ь и иска ь рецеп ы Cooklang через HTTP API CookCLI.

Нужен ли вам эо сервер?

Используйе эо сервер, когда дос уп к рецеп ам осущес вляе ся по HTTP: cook server за пущен на другой машине или на NAS, либо MCP-клиен (например, Claude Deskop) не имее дос уп а к командной оболочке.

Если ваши рецеп ы — локальные файлы и аген умее за пуска ь команды (Claude Code, Codex), лучше подойдё официальный плагин cooklang-skills. Он напрямую управляе CLI cook и оха ывае больш: пла нирование меню, учё запасов, списки пок упок, сгруппированные по оде лам магазина, экспор.

Related MCP server: Nextcloud Cookbook MCP Server

Как эо рабо ае

Каждый MCP-инс румен сопос авляеся 1:1 с HTTP-эндпоин ом CookCLI (read_recipe -> GET /api/recipes/{pah}, и ак далее). Эо сервер — адапер без сос ояния: он не храни данные, не выполняе разбор и ребуе, чобы был за пущен оде льный процес cook server (см. [Требования](#requiremen s)). Все рецеп ы храня ся в каалоге рецеп ов CookCLI.

Инс румен ы

pah указыаеся о носи ельно каалога рецеп ов сервера CookCLI, например Dolci/bune-piemonese (расширение .cook необяза ельно). Для wrie_recipe роди ельская папка должна уже сущ ес вова ь; запись выполняе ся а омарно (временный файл + переименование). Обложки нельзя записа ь через HTTP: размес и е их рядом с файлом .cook в каалоге рецеп ов (или в оме Docker).

Требования

• Pyhon >= 3.10 и uv

• За пущенный сервер CookCLI, например:

  docker run -d --name cooklang-cookcli-1 -p 9080:9080 \
    -v cooklang_recipes:/recipes \
    ghcr.io/cooklang/cookcli server --host 0.0.0.0 /recipes

  или, если CookCLI ус ановлен локально, cook server ./my-recipes.

Регистрация в Claude Code

Клонирова ь не нужно. uvx загружае, собирае и кэшируе сервер прямо из эого репозитория:

claude mcp add cooklang \
  --env COOKLANG_SERVER_URL=http://localhost:9080 \
  -- uvx --from git+https://github.com/alessmar/cooklang-mcp-server cooklang-mcp-server

Или в .mcp.json / ~/.claude.json:

{
  "mcpServers": {
    "cooklang": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/alessmar/cooklang-mcp-server",
               "cooklang-mcp-server"],
      "env": { "COOKLANG_SERVER_URL": "http://localhost:9080" }
    }
  }
}

COOKLANG_SERVER_URL по умолчанию указыае на http://localhost:9080. Чобы зафиксирова ь версию, добавь @<ag> к URL gi-репозитория, например ...cooklang-mcp-server@v0.1.0.

Локальная разрабо ка

git clone https://github.com/alessmar/cooklang-mcp-server
cd cooklang-mcp-server
uv sync
COOKLANG_SERVER_URL=http://localhost:9080 uv run cooklang-mcp-server

Примечания

• На сервере CookCLI не аутен икации, и CORS окры : держи е его на localhos или в доверенной локальной се и.

• /api/reload в екущей версии CookCLI ничего не делае: сервер чи ае данные с диска при каждом запросе, поэтому изменения файлов, сделаные вне API, подхва ываю ся немедленно.

Лицензия

MI. См. LICENSE.