convex-mcp-server logo

convex-mcp-server

by handfuloflight

This is a TypeScript-based MCP server that implements a simple notes system. It demonstrates core MCP concepts by providing resources representing text notes and tools for creating new notes.

View on GitHub

Last updated: N/A

What is convex-mcp-server?

A TypeScript-based MCP server implementing a simple notes system, demonstrating core MCP concepts.

How to use convex-mcp-server?

  1. Install dependencies using npm install. 2. Build the server using npm run build. 3. Configure Claude Desktop by adding the server config to ~/Library/Application Support/Claude/claude_desktop_config.json (MacOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows). 4. Debug using the MCP Inspector with npm run inspector.

Key features of convex-mcp-server

  • List and access notes via note:// URIs

  • Notes have title, content, and metadata

  • Plain text mime type for simple content access

  • create_note tool for creating new notes

Use cases of convex-mcp-server

  • Creating and managing text-based notes within an MCP environment

  • Demonstrating core MCP resource and tool concepts

  • Integrating with Claude Desktop for note management

  • Developing and debugging MCP servers

FAQ from convex-mcp-server

What is an MCP server?

An MCP server is a server that implements the Model Context Protocol, allowing it to interact with other MCP-compatible applications.

What is the purpose of this server?

This server provides a simple notes system to demonstrate core MCP concepts.

How do I install the dependencies?

Run npm install in the server's root directory.

How do I debug the server?

Use the MCP Inspector by running npm run inspector.

Where do I configure the server for Claude Desktop?

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