Convex MCP Server

🚀 凸面 MCP サーバー

このサーバーは TypeScript をベースに構築された MCP サーバーで、シンプルなノートシステムを実装しています。以下の機能を通じて、核心的な MCP 概念を示しています。

• リソース：note:// URI を通じて、タイトル、内容、メタデータを持つテキストノートを一覧表示し、アクセスできます。
• ツール：新しいノートを作成するための create_note ツールが用意されています。

✨ 主な機能

リソース

• note:// URI を使用してノートを一覧表示し、アクセスできます。
• 各ノートにはタイトル、内容、メタデータが含まれています。
• plain text MIME タイプを使用して、簡単に内容にアクセスできます。

ツール

• create_note：新しいテキストノートを作成します。
  • タイトルと内容を必須パラメータとして受け取ります。
  • ノートをサーバーの状態に保存します。

📦 インストール

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

🚀 クイックスタート

依存関係のインストール

npm install

サーバーのビルド

npm run build

自動再構築機能付きの開発

npm run watch

💻 使用例

基本的な使用法

このサーバーを使用するには、まず依存関係をインストールし、サーバーをビルドします。その後、Claude Desktop の設定ファイルにサーバー設定を追加します。

# 依存関係のインストール
npm install
# サーバーのビルド
npm run build

高度な使用法

自動再構築機能を使用して開発することができます。これにより、コードを変更するたびに自動的にサーバーが再構築されます。

npm run watch

🔧 デバッグ

MCP サーバーは標準入出力を通じて通信するため、デバッグが難しい場合があります。MCP Inspector を使用することをおすすめします。これは、以下のコマンドで実行できるツールです。

npm run inspector

Inspector は、ブラウザでアクセスできるデバッグツールの URL を提供します。