mcp-low-level -streamable-http

This MCP server implements a simple, low-level, streamable HTTP-based MCP server written in TypeScript. It exposes a resource model for notes that are addressed by URIs like note://, each note containing a title, content and metadata, and served as plain text. The server also provides a tool called create_note for creating new text notes, which stores the result in the server's in-memory state. Additionally, there is a prompt generator summarize_notes that compiles a structured prompt containing the contents of all notes to be summarized by an LLM. You can access notes via their note:// URIs and request embedded resources or metadata as MCP resources, while using the provided tools to modify or generate summaries of stored content.

Prerequisites:

• Node.js (recommended LTS) and npm installed on your system
• A compatible environment for running HTTP-based MCP servers

Steps:

1. Clone the repository or download the source code.
2. Install dependencies:

npm install

3. Build the server (transpile TypeScript to JavaScript):

npm run build

4. Start the server:

npm start

5. The server will listen on port 3001 by default (adjust via PORT envvar if needed). Example to run on a custom port:

PORT=4000 npm start

6. Optional: integrate with Claude Desktop as shown in the README by adding the MCP server config to your Claude configuration file.

Notes:

• The MCP server stores notes in memory for the duration of the process. Restarting the server will reset stored notes unless a persistence mechanism is added.
• Access resources via note:// URIs and use the create_note tool to persist new notes.
• If you encounter debugging issues, you can run the MCP Inspector tool (npm run inspector) to obtain a debugging URL.
• The default HTTP endpoint is http://localhost:3001/mcp; configure your client to use this endpoint.
• Ensure the environment variable PORT is set if you run on a port different from 3001.
• When integrating with Claude Desktop or other clients, use the provided JSON snippet in the installation/configuration section to describe the MCP server.