ServiceStack

TypeScript MCP server with a notes data model, create_note tool, and summarize_notes prompt to manage and summarize notes.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "servicestack-servicestack-mcp": {
      "command": "/path/to/@servicestack/mcp/build/index.js",
      "args": [],
      "env": {
        "NODE_OPTIONS": "\"--max-old-space-size=2048\""
      }
    }
  }
}

You run a small TypeScript-based MCP server that exposes a simple notes system. It lets you create, access, and summarize notes through MCP-compatible tools and prompts, making it easy to explore API interactions in a contained environment.

How to use

You interact with the server using an MCP client. Create new notes with the create_note tool by providing a title and content. Retrieve and view existing notes via note:// URIs, which expose each note’s title, content, and metadata. To generate a summary of all stored notes, invoke the summarize_notes prompt, which returns a structured prompt suitable for an LLM to summarize the collection of notes.

How to install

Prerequisites you need installed on your system before starting:

Node.js (recommended) and npm are required to build and run the MCP server
A modern shell or terminal to run commands

Step-by-step commands to set up and run the server locally:

# 1) Install dependencies
npm install

# 2) Build the server
npm run build

# 3) (Optional for development) Auto-rebuild on changes
npm run watch

# 4) Debugging tools (Inspector) for MCP
npm run inspector

Configuration and startup notes

To connect this MCP server with Claude Desktop or other MCP clients, you can use the following local startup configuration. This example points to the built MCP server entry script as a stdio host.

{
  "mcpServers": {
    "@servicestack/mcp": {
      "command": "/path/to/@servicestack/mcp/build/index.js"
    }
  }
}

Available tools

create_note

Create a new text note by providing a title and content; stores the note in server state.

summarize_notes

Generate a summary of all stored notes, including note contents as embedded resources, suitable for an LLM.