Overview
What is notes-mcp-server?
notes-mcp-server is a Model Context Protocol (MCP) server that provides AI assistants with a secure and structured way to perform CRUD operations on simple notes. Notes are persisted using Apache Ignite.
How to use notes-mcp-server?
Install prerequisites (Python with uv, MCP dependencies, Apache Ignite), then clone the repo and run the server using uv run main.py. Pass --host and --port to configure the database connection. Example usage for Claude Desktop and Continue.dev is provided in the README.
Key features of notes-mcp-server
- CRUD operations for simple notes
- Notes persisted via Apache Ignite
- Implements
list_resources,read_resource,list_tools,call_tool,list_prompts,get_prompt - Supports stdio transport for MCP clients
- Configurable database host and port
- Open source under MIT license
Use cases of notes-mcp-server
- AI assistants that need to create and retrieve personal notes
- Integrating a note‑taking capability into Claude Desktop or Continue.dev
- Prototyping an MCP server with a persistent data store
- Teaching or exploring the Model Context Protocol
FAQ from notes-mcp-server
What dependencies does notes-mcp-server require?
Python with the uv package manager, MCP server dependencies, and Apache Ignite.
How do I configure the database connection?
Pass the --host and --port arguments when running the server, e.g., --host=127.0.0.1 --port=10800.
Can I use notes-mcp-server with Claude Desktop?
Yes. Add a configuration entry to Claude’s MCP settings file using the uv command as shown in the README.
What license is notes-mcp-server released under?
MIT License – see the LICENSE file in the repository.
Where are the notes stored?
Notes are persisted in an Apache Ignite database. The server connects to an Ignite instance via the configured host and port.
