convex-mcp-server MCP Server について
convex-mcp-serverは、シンプルなテキストメモ機能でMCPの概念を示すTypeScript製MCPサーバーです。MCPのリソースやツールを試す開発者向けで、URIからメモにアクセスし、ツールで作成できます。
主な機能
- 01URIによるメモの一覧・読み取り
- 02メモのタイトル、内容、メタデータ公開
- 03ツールによるメモ作成
- 04サーバー状態へのメモ保存
活用シーン
- 01MCPのリソースアクセス方式の検証
- 02MCPクライアントからテキストメモを作成
MCP 対応
テキストメモを`note://` URIでアクセスできるリソースとして公開し、追加用の`create_note`ツールを提供します。Claude Desktopで使うよう設定できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
convex-mcp-server MCP サーバー
Convex MCP サーバー
これは、シンプルなメモシステムを実装した TypeScript ベースの MCP サーバーです。以下を提供することで、MCP の主要な概念を紹介します。
- URI とメタデータを持つテキストメモを表すリソース
- 新しいメモを作成するツール
機能
リソース
note://URI を使ってメモを一覧表示およびアクセスできます- 各メモにはタイトル、内容、メタデータがあります
- 内容に簡単にアクセスできるプレーンテキストの MIME タイプです
ツール
create_note- 新しいテキストメモを作成します- 必須パラメーターとしてタイトルと内容を受け取ります
- メモをサーバーの状態に保存します
開発
依存関係をインストールします:
npm install
サーバーをビルドします:
npm run build
自動再ビルドを有効にして開発する場合:
npm run watch
インストール
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 サーバーは stdio 経由で通信するため、デバッグは難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。
npm run inspector
Inspector から、ブラウザーでデバッグツールにアクセスするための URL が提供されます。
convex-mcp-server
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。