cooklang-mcp-server

작은 FastMCP 서버로, CookCLI 레시피 서버(cook server, ghcr.io/cooklang/cookcli에 포함됨)를 코딩 에이전트에게 MCP 도구로 노출합니다. 이를 통해 에이전트는 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를 참조하세요.