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:

1. Setting the SPOONACULAR_API_KEY environment variable
2. 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.