convex

The convex-mcp-server is a TypeScript MCP server that implements a simple notes system. It exposes a resource model for text notes that can be accessed via note:// URIs and provides a tool named create_note to create new text notes. Notes have a title, content and metadata, and are stored in the server state. The server demonstrates core MCP concepts such as resources and tools, making it suitable for experimentation with MCP-enabled clients like Claude Desktop or other MCP tooling. To interact with the server, start it and connect an MCP client to its standard input/output streams; the client can query the list of notes, fetch note content, and invoke create_note to add new notes.

Prerequisites:

• Node.js and npm installed on your system
• Basic familiarity with running JavaScript/TypeScript projects

Installation steps:

1. Install dependencies npm install

2. Build the server (for development and production builds) npm run build

3. Run the server (example using Node to execute the built index) npm start

4. Optional: develop with auto-rebuild during changes npm run watch

5. If you plan to integrate with Claude Desktop, prepare the configuration and point Claude at the built server as shown in the installation example from the README.

Tips and notes:

• The server exposes a notes resource where each note has a title, content (plain text), and metadata. Access is typically via note:// URIs.
• The create_note tool accepts title and content as required parameters and stores the new note in the server state.
• For debugging MCP interactions, you can use the MCP Inspector tool, often invoked via npm run inspector, which provides a browser-based debugging interface and a URL for access.
• When configuring Claude Desktop, ensure the path to the built server (build/index.js) is correct in your claude_desktop_config.json under mcpServers.convex-mcp-server.command.
• If you modify the server, re-build before running to ensure the latest changes are used.