Convex MCP Server Quick Start Guide

概述

Convex MCP Server 是一个基于 TypeScript 的 MCP 服务器，提供简单的笔记系统功能：

• 通过 note:// URI 访问文本笔记资源
• 创建新笔记的工具

安装与设置

1. 安装依赖

   npm install
   

2. 构建服务器

   npm run build
   

   开发时启用自动重建：

   npm run watch
   

3. 配置 Claude Desktop

   添加服务器配置到：

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

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

主要功能

资源

• 通过 note:// URI 列出和访问笔记
• 每个笔记包含标题、内容和元数据

工具

• create_note - 创建新笔记
  • 参数：标题和内容（必需）
  • 在服务器状态中存储笔记

调试

使用 MCP Inspector 进行调试：

npm run inspector

访问浏览器中提供的 URL 以使用调试工具。