sample-mcp-server MCP Server について
sample-mcp-serverは、MCPを学ぶ開発者向けにシンプルなノート機能を実装したTypeScript製MCPサーバーです。ノートをリソースとして公開し、作成ツールと要約プロンプトを備えています。
主な機能
- 01URIによるノートの一覧と取得
- 02ツールでのノート作成
- 03プロンプトによるノート要約
- 04サーバー状態へのノート保存
活用シーン
- 01MCPリソースアクセスのテスト
- 02テキストノートの作成と保存
- 03LLM要約用ノートの準備
MCP 対応
MCPクライアントにノートリソース、ノート作成ツール、要約プロンプトを提供します。READMEではClaude Desktopの設定とMCP Inspectorによるデバッグも説明しています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
sample-mcp-server MCP サーバー
Model Context Protocol サーバー
これは、シンプルなメモシステムを実装する TypeScript ベースの MCP サーバーです。以下を提供することで、MCP の基本概念を紹介します。
- URI とメタデータを持つテキストメモを表すリソース
- 新しいメモを作成するツール
- メモの要約を生成するプロンプト
機能
リソース
note://URI を使用してメモを一覧表示し、アクセスできます- 各メモにはタイトル、内容、メタデータがあります
- シンプルなコンテンツアクセスのためのプレーンテキスト MIME タイプ
ツール
create_note- 新しいテキストメモを作成します- 必須パラメーターとしてタイトルと内容を受け取ります
- メモをサーバーの状態に保存します
プロンプト
summarize_notes- 保存されているすべてのメモの要約を生成します- すべてのメモの内容を埋め込みリソースとして含めます
- LLM による要約のための構造化されたプロンプトを返します
開発
依存関係をインストールします:
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": {
"sample-mcp-server": {
"command": "/path/to/sample-mcp-server/build/index.js"
}
}
}
デバッグ
MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。
npm run inspector
Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。