Skip to main content
Glama
notes-box

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers