Convex MCP Server

🚀 Convex MCP Server

This is a TypeScript-based MCP server that implements a simple note-taking system. It demonstrates core MCP concepts through the following features.

🚀 Quick Start

This TypeScript-based MCP server showcases the fundamental concepts of MCP by implementing a straightforward note-taking system. It offers the following capabilities:

• Resources: List and access text notes with titles, content, and metadata via the note:// URI.
• Tools: The create_note tool for creating new notes.

✨ Features

Resources

• List and access notes via the note:// URI.
• Each note includes a title, content, and metadata.
• Provide simple content access using the plain text MIME type.

Tools

• create_note: Create a new text note.
  • Accepts title and content as required parameters.
  • Stores the note in the server state.

📦 Installation

Install Dependencies

npm install

Build the Server

npm run build

Development with Auto Rebuild

npm run watch

Configuration on Claude Desktop

To use this server on Claude Desktop, add the following server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "convex-mcp-server": {
      "command": "/path/to/convex-mcp-server/build/index.js"
    }
  }
}

🔧 Technical Details

Debugging

Debugging can be challenging since MCP servers communicate via standard input and output. We recommend using MCP Inspector, which can be run with the following command:

npm run inspector

The Inspector will provide a URL that allows you to access the debugging tools in your browser.