Skip to main content
Glama
artemki207775

notes-box

my-mcp-server-kit

Learning MCP: tiny notes server with five tools

Examples

# claude_desktop_config.json  (use ABSOLUTE paths: Claude does not
# run from the repo directory, so a bare "server.py" is not found)
# {
#   "mcpServers": {
#     "notes-box": {
#       "command": "python",
#       "args": ["/abs/path/to/my-mcp-server-kit/server.py"],
#       "env": {"MCP_NOTES_FILE": "/abs/path/to/notes.json"}
#     }
#   }
# }
python server.py --help

Related MCP server: notes-box

Install

pip install -r requirements.txt

Features

  • Atomic saves (temp file + os.replace) behind a write lock

  • Includes a Claude Desktop config snippet with absolute paths

  • Notes path set by MCP_NOTES_FILE or --notes-file

  • Five tools: add / get / update / delete / list notes

  • Every tool carries a real docstring, so clients get descriptions

  • A missing note raises instead of returning the string 'not found'

Project structure

├── .github/
│   └── workflows/
│       └── ci.yml
├── docs/
│   ├── roadmap.md
│   └── usage.md
├── examples/
│   └── quickstart.md
├── tests/
│   └── test_notes.py
├── .gitignore
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── requirements.txt
└── server.py

Development

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

说明

个人练习项目, 谨慎用于生产环境。

License

MIT licensed, see LICENSE.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers