mcp

MCP Server

Project Context

This is a Model Control Protocol (MCP) server that is a minimal wrapper that exposes a few endpoints from the Neon REST API as MCP tools so AI agents can use them.

What is MCP?

MCP is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools.

MCP Clients are protocol clients that maintain 1:1 connections with servers.

MCP Servers, such as this one, are lightweight programs that each expose specific capabilities through the standardized Model Context Protocol.

Format for defining tools

Edit the src/index.ts file to add new tools. Each method in the MyWorker class becomes an MCP tool that can be used by your Cursor Agent.

For example, here is an example of an MCP tool that returns a friendly greeting:

/**
 * A warm, friendly greeting from your new Workers MCP server.
 * @param name {string} the name of the person we are greeting.
 * @return {string} the contents of our greeting.
 */
sayHello(name: string) {
    return `Hello from an MCP Worker, ${name}!`;
}

• The JSDoc comment's first line is the tool's description.
• The @param tags are the tool's parameters, with their types and descriptions.
• The @return tag is the tool's return value, with its type.

To add a new tool, just write a new function to the MyWorker class, following the example above. Make sure to add the JSDoc comment in the exact format shown above with the correct types so that the compiler parses it correctly.

How to write functions to wrap APIs

Most of the time, you will be writing tools that return objects that are a lot more complex than simple strings. To comply with the MCP Tools Spec, you must stringify the object to text and return responses in this shape.