goodbook-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@goodbook-mcp what are the cooking guidelines for pasta?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Goodbook MCP Server
A modern Model Context Protocol (MCP) server that works exclusively with PDF files containing food service standards and preparation guidelines. Built following MCP best practices with robust input validation and error handling.
Overview
The Goodbook MCP server allows AI assistants to query and retrieve information from food service documentation, including:
Food preparation standards
Cooking guidelines and methods
Food safety information
Recipe standards
Hygiene and sanitation requirements
Related MCP server: MCP PDF Reader
Modern Architecture
This server follows current MCP best practices:
Zod input validation for all tool parameters
Proper STDIO usage with
console.errorfor loggingRobust error handling with detailed error messages
Optimized tool definitions with automatic schema conversion
Comprehensive synonym support for Russian cooking terms
Clean separation of concerns between parsing, validation, and execution
Features
Available Tools
search_food_standards: Search for specific food preparation standards, recipes, or cooking guidelines
get_cooking_guidelines: Get cooking guidelines and standards for specific dishes or cooking methods
list_sections: List all available sections in the food service standards document
get_section_content: Get content from a specific section of the food standards document
get_food_safety_info: Get food safety information and hygiene standards
find_recipe_standards: Find standardized recipes and preparation methods for specific dishes
Installation
Ensure you have Node.js 18+ installed
Clone or download this project
Install dependencies:
npm installREQUIRED: Place your PDF file named
menu.pdfin the root directory
Usage
Running the Server
npm startThe server will start and listen for MCP protocol messages via stdio.
Development Mode
npm run devThis will start the server with auto-reload on file changes.
MCP Client Configuration
To use this server with an MCP-compatible client, add the following configuration:
Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"goodbook": {
"command": "node",
"args": ["c:/указываем-полный-путь-к-файлу/mcp/src/index.js"],
"env": {}
}
}
}Other MCP Clients
Configure your MCP client to run:
node src/index.jsTool Usage Examples
Search for Food Standards
Use the search_food_standards tool to find information about temperature requirements:
- query: "температура приготовления"
- section: (optional) specify a particular sectionGet Cooking Guidelines
Use get_cooking_guidelines to get preparation methods:
- dish_type: "паста"
- section: (optional)Food Safety Information
Use get_food_safety_info for safety guidelines:
- topic: "хранение мяса"File Structure
goodbook-mcp-server/
├── src/
│ ├── index.js # Main MCP server
│ ├── tools.js # Tool implementations
│ └── pdf-parser.js # PDF parsing logic
├── menu.pdf # Source PDF document
├── package.json # Project configuration
└── README.md # This fileRequirements
Node.js 18.0.0 or higher
PDF document (
menu.pdf) containing food service standardsMCP-compatible client (like Claude Desktop)
Error Handling
The server includes comprehensive error handling for:
PDF parsing failures
Missing sections
Invalid search queries
Tool execution errors
All errors are returned as structured responses to the MCP client.
Development
Adding New Tools
Add tool definition to
getToolDefinitions()intools.jsImplement handler method in
GoodbookToolsclassAdd case to
handleTool()switch statement
Modifying PDF Parsing
Edit the PDFParser class in pdf-parser.js to:
Change section detection patterns
Modify content extraction logic
Add new search capabilities
License
MIT License
Support
For issues or questions, please check the error logs when running the server. The server outputs detailed logging information to help diagnose problems.
Available Tools
6 toolsfind_recipe_standardsC
Find standardized recipes and preparation methods for specific dishes
Inputs: dish_name (required), cuisine_type.
get_cooking_guidelinesC
Get cooking guidelines and standards for specific dishes or cooking methods
Inputs: dish_type (required), section.
get_food_safety_infoC
Get food safety information and hygiene standards
Inputs: topic (required).
get_section_contentC
Get content from a specific section of the food standards document
Inputs: section_name (required), limit (required).
list_sectionsB
List all available sections in the food service standards document
Inputs: no named parameters.
search_food_standardsC
Search for specific food preparation standards, recipes, or cooking guidelines in the food service literature
Inputs: query (required), section.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
There is significant overlap between tools like find_recipe_standards, get_cooking_guidelines, and search_food_standards, which all seem to retrieve similar types of information about recipes, guidelines, and standards. However, the descriptions provide some differentiation, such as get_food_safety_info focusing on safety/hygiene and list_sections/get_section_content being more structural. The overlapping purposes could lead to confusion when selecting the right tool for a query.
The tool names follow a consistent verb_noun pattern with snake_case throughout, such as find_recipe_standards and get_cooking_guidelines. All tools start with verbs like 'find', 'get', 'list', or 'search', which is predictable and readable. There are no deviations in naming conventions, making it easy to parse the tool set at a glance.
With 6 tools, the count is well-scoped for a server focused on food service standards and recipes. This number is neither too thin nor too heavy, allowing for a focused set of operations without overwhelming an agent. Each tool appears to serve a distinct purpose within the domain, making the count appropriate for the server's apparent scope.
The tool set covers core operations for accessing food standards, recipes, safety info, and document structure, providing good coverage for retrieval and search within the domain. However, there are minor gaps, such as no tools for updating or managing standards (e.g., create or modify operations), which might limit agents in more dynamic workflows. Overall, it supports essential querying tasks effectively.
Maintenance
Related MCP Connectors
MCP server for the PDFGate API. Generate PDFs, manage documents and handle e-signatures.
MCP server for detecting and redacting PII (Personally Identifiable Information) in PDF documents.
MCP server for querying Forkast documentation
MCP server for Api2Pdf — generate PDFs & images from HTML, URLs or office files; merge, barcodes.
Related MCP Servers
- FlicenseAqualityNot gradedmaintenanceA Model Context Protocol server that extracts and processes content from PDF documents, providing text extraction, metadata retrieval, page-level processing, and PDF validation capabilities.41-
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables the extraction of text, metadata, and embedded images from PDF files. It provides tools for searching text with context, reading specific pages, and counting total pages within a document.745 npm1MIT
- AlicenseAqualityBmaintenanceAn MCP (Model Context Protocol) server that provides structured access to ISO 32000 (PDF) specification documents. Enables LLMs to navigate, search, and analyze PDF specifications through well-defined tools.8201 npm2MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that exposes PDF files as resources, page by page, over Streamable HTTP.-