Spoonacular Server
What is Spoonacular Server
spoonacular-server is a Model Context Protocol (MCP) server designed to interface with the Spoonacular API, providing access to a variety of recipe-related functionalities.
Use cases
Use cases include searching for recipes based on user input, retrieving detailed instructions and ingredients for specific recipes, and integrating recipe functionalities into various food-related applications.
How to use
To use the spoonacular-server, set up the Spoonacular API key as an environment variable or replace the placeholder in the code. Install dependencies using npm, build the server, and configure it in your application as specified in the README.
Key features
Key features include tools for searching recipes by keywords and retrieving detailed recipe information, both returning data in JSON format.
Where to use
spoonacular-server can be used in applications that require recipe search and information retrieval, such as cooking apps, meal planning tools, and food blogs.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Spoonacular Server
spoonacular-server is a Model Context Protocol (MCP) server designed to interface with the Spoonacular API, providing access to a variety of recipe-related functionalities.
Use cases
Use cases include searching for recipes based on user input, retrieving detailed instructions and ingredients for specific recipes, and integrating recipe functionalities into various food-related applications.
How to use
To use the spoonacular-server, set up the Spoonacular API key as an environment variable or replace the placeholder in the code. Install dependencies using npm, build the server, and configure it in your application as specified in the README.
Key features
Key features include tools for searching recipes by keywords and retrieving detailed recipe information, both returning data in JSON format.
Where to use
spoonacular-server can be used in applications that require recipe search and information retrieval, such as cooking apps, meal planning tools, and food blogs.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
spoonacular-server MCP Server
English | 简体中文
A Model Context Protocol server for Spoonacular API
This is a TypeScript-based MCP server that provides access to the Spoonacular recipe API. It demonstrates core MCP concepts by providing:
- Tools for searching recipes by keywords
- Tools for retrieving detailed recipe information
- JSON responses with recipe data
Features
Tools
-
search_recipes- Search for recipes based on keywords- Takes query string as a required parameter
- Returns a list of matching recipes in JSON format
-
get_recipe_information- Get detailed information about a specific recipe- Takes recipe ID as a required parameter
- Returns comprehensive recipe details in JSON format
API Key Setup
This server requires a Spoonacular API key to function. You can set it by:
- Setting the
SPOONACULAR_API_KEYenvironment variable - Directly replacing the placeholder in the code
If you don’t have an API key, you can get one by signing up at Spoonacular API.
Development
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Installation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"spoonacular-server": {
"command": "/path/to/spoonacular-server/build/index.js"
}
}
}Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
