cooklang-mcp-server

CookCLI レシピサーバー（cook server、ghcr.io/cooklang/cookcli に同梱）を MCP ツールとしてコーディングエージェントに公開する、小さな FastMCP サーバーです。これにより、エージェントは CookCLI HTTP API 経由で Cooklang レシピの閲覧、読み取り、書き込み、削除、検索ができます。

これは必要ですか？

レシピに HTTP 経由でアクセスする場合は、このサーバーを使用してください。すなわち、別のマシンや NAS 上で動作している cook server、またはシェルアクセスを持たない Claude Desktop などの MCP クライアントです。

レシピがローカルファイルであり、エージェントがコマンドを実行できる場合（Claude Code、Codex）は、公式の cooklang-skills プラグインの方が適しています。これは cook CLI を直接操作し、食事計画、パントリーの追跡、通路ごとにグループ化された買い物リスト、エクスポートなど、より広い範囲をカバーします。

Related MCP server: Nextcloud Cookbook MCP Server

仕組み

各 MCP ツールは CookCLI HTTP エンドポイントに 1:1 で対応します（read_recipe -> GET /api/recipes/{path} など）。このサーバーはステートレスなアダプターです。データを保持せず、パースも行わず、別途 cook server プロセスが実行されている必要があります（要件 を参照）。すべてのレシピは CookCLI のレシピディレクトリに置かれます。

ツール

path は CookCLI サーバーのレシピディレクトリを基準にした相対パスです（例: Dolci/bunet-piemontese。.cook 拡張子は省略可能です）。write_recipe は親フォルダがすでに存在している必要があり、アトミックに書き込みます（一時ファイル + リネーム）。タイトル画像は HTTP 経由では書き込めません。レシピディレクトリ（または Docker ボリューム）内の .cook ファイルの隣に配置してください。

要件

• Python >= 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 になります。git URL に @<tag> を追加してバージョンを固定できます。例: ...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 はオープンです。localhost または信頼できる LAN 上に置いてください。

• /api/reload は現在の CookCLI では no-op です。サーバーはリクエストのたびにディスクから読み取るため、API 外で行われたファイル変更はすぐに反映されます。

ライセンス

MIT。 LICENSE を参照してください。