What is Ts Mcp

The ts_mcp is a TypeScript-based Model Context Protocol server that implements a simple notes system. It facilitates the creation, management, and summarization of text notes through structured URIs and metadata, showcasing the core concepts of the Model Context Protocol.

Use cases

It can be used for organizing personal notes, collaborative documentation, or any scenario that requires effective note-taking and retrieval. Users can create and summarize notes efficiently, making it suitable for students, professionals, or anyone in need of a simple note management system.

How to use

To use the server, install the dependencies using npm, build the project, and configure it with the Claude Desktop application by specifying the server command in the configuration file. Once set up, users can create notes and request summaries of their content.

Key features

Key features include the ability to create notes with titles and content, access notes via unique URIs, and generate summaries of all stored notes. The server supports plain text content and provides structured prompts for language model summarization.

Where to use

This MCP server is ideal for use in desktop applications like Claude, as well as in any other environment that can leverage Model Context Protocol servers for effective note-taking and summarization tasks.

ts_mcp 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": {
    "ts_mcp": {
      "command": "/path/to/ts_mcp/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.