drio
Open app

convex-mcp-server MCP Server

Source

Mirror of

Catalog onlyCatalog onlySTDIO

Overview

convex-mcp-server is a TypeScript-based MCP (Model Context Protocol) server that implements a simple notes system, demonstrating core MCP concepts through resources and tools for managing text notes.

To use the convex-mcp-server, install the necessary dependencies, build the server, and configure it with Claude Desktop by adding the server configuration to the appropriate JSON file based on your operating system.

  • Resources representing text notes with URIs and metadata. - Tools for creating new notes with required parameters (title and content). - Each note can be accessed via note:// URIs, with plain text mime type for simple content access.
  1. Creating and managing text notes in a structured format.
  2. Integrating with applications that support MCP for enhanced note-taking capabilities.
  3. Debugging and inspecting MCP server communications using the MCP Inspector tool.

Add to your AI client

Use these steps to connect convex-mcp-server MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "handfuloflight-convex-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-handfuloflight-convex-mcp-server-mcp-mirror"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "handfuloflight-convex-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-handfuloflight-convex-mcp-server-mcp-mirror"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "handfuloflight-convex-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-handfuloflight-convex-mcp-server-mcp-mirror"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "handfuloflight-convex-mcp-server-mcp-mirror": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-handfuloflight-convex-mcp-server-mcp-mirror"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "handfuloflight-convex-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-handfuloflight-convex-mcp-server-mcp-mirror"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "handfuloflight-convex-mcp-server-mcp-mirror": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-handfuloflight-convex-mcp-server-mcp-mirror"
      ]
    }
  }
}

FAQ

What is the purpose of the convex-mcp-server?

It serves as a simple notes system that demonstrates the Model Context Protocol concepts.

How do I install and run the server?

You can install it by running `npm install`, build it with `npm run build`, and configure it for use with Claude Desktop.

Can I debug the server?

Yes, you can use the MCP Inspector for debugging, which provides a URL to access debugging tools in your browser.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":647,"uuid":"5fc5e549-81e8-4c36-afae-473b26642ab7","name":"handfuloflight_convex-mcp-server","title":"convex-mcp-server MCP Server","description":"Mirror of","avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","created_at":"2024-12-30T03:25:04.392Z","updated_at":"2025-02-23T07:15:13.871Z","status":"created","author_name":"MCP-Mirror","author_avatar_url":"https://avatars.githubusercontent.com/u/192820360?v=4","tags":"mcp-server,typescript,notes-system","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MCP-Mirror/handfuloflight_convex-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools