MCP ExplorerExplorer

Convex Mcp Server

@handfuloflighton a year ago
1 MIT
FreeCommunity
AI Systems
A TypeScript-based MCP server for managing text notes with URIs.

Overview

What is Convex Mcp Server

The convex-mcp-server is a TypeScript-based MCP server that implements a simple notes system, showcasing core MCP concepts through resources and tools for managing text notes.

Use cases

Use cases for the convex-mcp-server include creating a personal note-taking application, integrating with other software for managing notes, or developing educational tools that require note creation and retrieval functionalities.

How to use

To use the convex-mcp-server, install the necessary dependencies with ‘npm install’, build the server using ‘npm run build’, and configure it in the Claude Desktop application by adding the server configuration to the appropriate JSON file.

Key features

Key features include the ability to list and access notes via ‘note://’ URIs, each note containing a title, content, and metadata, as well as tools for creating new notes with the ‘create_note’ command.

Where to use

The convex-mcp-server can be used in applications that require a simple note-taking system, suitable for personal productivity tools, educational software, or any context where text note management is needed.

Content

convex-mcp-server MCP Server

Convex MCP Server

This is a TypeScript-based MCP server that implements a simple notes system. It demonstrates core MCP concepts by providing:

  • Resources representing text notes with URIs and metadata
  • Tools for creating new notes

Features

Resources

  • List and access notes via note:// URIs
  • Each note has a title, content and metadata
  • Plain text mime type for simple content access

Tools

  • create_note - Create new text notes
    • Takes title and content as required parameters
    • Stores note in server state

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

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"
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

convex-mcp-server

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers