amazon-fresh-server

The amazon-fresh-server is an MCP server built with TypeScript that implements a simple notes system. It manages text notes with URIs and metadata as resources, providing tools for creating new notes and generating summaries of notes. The setup for the development environment is straightforward, allowing users to learn core MCP concepts through note creation and summarization features.

GitHub Stars

64

User Rating

Not Rated

Forks

6

Issues

1

Views

0

Favorites

0

README
amazon-fresh-server MCP Server

A Model Context Protocol server

This is a TypeScript-based MCP server that implements a simple notes system. It demonstrates core MCP concepts by providing:

  • Resources representing text notes with URIs and metadata
  • Tools for creating new notes
  • Prompts for generating summaries of notes
Features
Resources
  • List and access notes via note:// URIs
  • Each note has a title, content and metadata
  • Plain text mime type for simple content access
Tools
  • create_note - Create new text notes
    • Takes title and content as required parameters
    • Stores note in server state
Prompts
  • summarize_notes - Generate a summary of all stored notes
    • Includes all note contents as embedded resources
    • Returns structured prompt for LLM summarization
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": {
    "amazon-fresh-server": {
      "command": "/path/to/amazon-fresh-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.

Author Information
Alec Velikanov

doing some stuff sometimes

@101dotxyz @uclaLos Angeles, CA

31

Followers

30

Repositories

1

Gists

1

Total Contributions

Top Contributors

Threads