Skip to main content
Glama
7Fernando750

notes-box

by 7Fernando750

my-mcp-server-app

Learning MCP: tiny notes server with three tools

Features

  • Includes Claude Desktop config snippet

  • Three tools: add / get / list notes

  • State persisted to a JSON file in the home dir

  • FastMCP style: decorators, zero boilerplate

Related MCP server: mcp-snippetbox

Usage

# claude_desktop_config.json
# {
#   "mcpServers": {
#     "notes-box": {"command": "python", "args": ["server.py"]}
#   }
# }
python server.py

Install

pip install -r requirements.txt

Project structure

├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   └── bug_report.md
│   ├── dependabot.yml
│   └── pull_request_template.md
├── docs/
│   ├── development.md
│   ├── roadmap.md
│   └── usage.md
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── requirements.txt
└── server.py

Development

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pytest -q

Notes

  • mostly stable, edge cases remain

License

MIT. Do whatever you want.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables adding, retrieving, and listing notes, with state persisted to a JSON file in the home directory.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables Claude Desktop to add, get, and list notes, with state persisted to a JSON file in the home directory.
    MIT