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
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.
