Mvp MCP Server MD Notes

🚀 Minimal MCP Server for Markdown Notes Retrieval

This project aims to design a minimal MCP server that implements the Model-Context-Protocol and provides functions for retrieving and reading Markdown notes.

🚀 Quick Start

The project is designed to create a minimal MCP server with specific functionalities. Here's a high - level overview of what it does:

• Implement the Model - Context - Protocol in a minimal MCP server.
• Provide retrieval and reading functions for Markdown notes.
• Use the provided notes_MCP as the knowledge source.
• Keep the implementation simple as a minimum viable product.
• Use pure JavaScript (no TypeScript).

✨ Features

• MCP Protocol Support: The server implements the Model - Context - Protocol, handling discovery and invocation endpoints.
• Markdown Notes Handling: It offers functions to list, read, and search Markdown notes.

📦 Installation

1. Prerequisites: Make sure you have Node.js installed on your system.
2. Clone the Repository:

   git clone <repository_url>
   cd mcp - notes - server
   

3. Install Dependencies:

   npm install
   

💻 Usage Examples

Basic Usage

To start the server, run the following command:

node server.js

Advanced Usage

You can interact with the server using HTTP requests. For example, to discover available tools and functions:

curl http://localhost:3000/discover

📚 Documentation

Requirements

1. Create a minimal MCP server implementing the model context protocol.
2. Provide functionality to retrieve and read Markdown notes.
3. Use the provided notes_MCP as the knowledge source.
4. Keep the implementation simple (minimum viable product).
5. Use pure JavaScript (no TypeScript).

Technology Stack

• Runtime Environment: Node.js
• Framework: Express.js (a lightweight Web framework)
• Dependencies:
  • express (HTTP server)
  • cors (Cross - Origin Resource Sharing)
  • fs (Node.js file system for reading notes)
  • path (Path manipulation utility)

Architecture

A simple client - server architecture:

+-------------------+       +-------------------+       +-----------------+
| LLM Host          | ----> | MCP Server        | ----> | File System     |
| （Claude/Other LLM）|       |（Express Server） |       |（Note Storage） |
|                   | <---- |                   | <---- |                 |
+-------------------+       +-------------------+       +-----------------+

Directory Structure

mcp - notes - server/
├── package.json
├── server.js              # Entry file
├── routes/
│   └── mcp - router.js      # MCP protocol router
├── tools/
│   └── notes - tool.js      # Note retrieval implementation
└── notes/                 # Directory containing Markdown notes
    └── ... （Your.md files）

Components

1. MCP Router

Handles MCP protocol requests:

• Discovery Endpoint (/discover): Returns available tools and functions.
• Invocation Endpoint (/invoke): Handles tool function calls.

2. Notes Tool

Implements note retrieval functions:

• list_notes: Lists all available notes.
• read_note: Retrieves the content of a specific note.
• search_notes: Simple note search function.

Implementation Plan

1. Set up a basic Express server with CORS support.
2. Implement the MCP router with discovery and invocation endpoints.
3. Create the notes tool to implement basic file operations.
4. Connect the components and test with an LLM host.