# MCP Notes Server

A simple **Model Context Protocol (MCP)** Notes Server built with **Python** and **FastMCP**, integrated with **Claude Desktop**. This server allows Claude to create and manage notes through custom MCP tools.

## Features

* Create notes using MCP tools
* Store notes locally
* Integrate directly with Claude Desktop
* Lightweight and easy to extend
* Built using FastMCP

## Prerequisites

* Python 3.10+
* UV Package Manager
* Claude Desktop

## Installation

### 1. Create a Project

```bash
uv init
```

### 2. Install MCP

```bash
uv add "mcp[cli]"
```

### 3. Install the MCP Server

```bash
uv run mcp install main.py
```

## Running the Server

```bash
uv run main.py
```

## Claude Desktop Integration

After installing the MCP server, configure Claude Desktop to use it.

Example Claude configuration:

```json
{
  "mcpServers": {
    "notes-server": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH_TO_PROJECT",
        "run",
        "main.py"
      ]
    }
  }
}
```

Replace `PATH_TO_PROJECT` with the absolute path to your project directory.

## Project Structure

```text
.
├── main.py
├── notes.txt
├── pyproject.toml
├── uv.lock
└── README.md
```

## Tech Stack

* Python
* FastMCP
* Model Context Protocol (MCP)
* Claude Desktop
* UV

## Author

Dev Mallick