Handfuloflight Convex MCP Server

🚀 凸形 MCP 服務器

這是一個基於 TypeScript 的 MCP 服務器，實現了簡單的筆記系統。它通過資源表示與工具創建，演示了核心的 MCP 概念，為筆記管理提供了便捷的解決方案。

🚀 快速開始

本服務器基於 TypeScript 構建，實現了一個簡單的筆記系統，通過資源表示和工具創建，演示了核心 MCP 概念。

✨ 主要特性

資源

• 可通過 note:// URI 列表和訪問筆記。
• 每個筆記都具備標題、內容和元數據。
• 使用純文本 MIME 類型，便於簡單的內容訪問。

工具

• create_note：用於創建新的文本筆記。
  • 需指定標題和內容作為必填參數。
  • 會將筆記存儲在服務器狀態中。

📦 安裝指南

開發環境安裝

安裝依賴

npm install

構建服務器

npm run build

帶有自動重建的開發

npm run watch

與 Claude Desktop 集成安裝

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

調試說明

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們推薦使用 MCP Inspector，它作為包腳本提供：

npm run inspector

Inspector 將提供一個可在瀏覽器中訪問調試工具的 URL。