my-server MCP Server について
my-server MCP Serverは、TypeScriptで実装されたシンプルなノートシステムのサンプルです。ノートの作成と要約を通じて、MCPのリソース、ツール、プロンプトを学ぶ開発者向けです。
主な機能
- 01URIでノートをリソースとして公開
- 02ノートのタイトル、内容、メタデータを保存
- 03ツールによるノート作成
- 04ノート要約用プロンプトの提供
活用シーン
- 01MCPのリソースアクセス方法を学習
- 02テキストノートの作成と保存
- 03保存したノートをLLM要約に渡す
MCP 対応
ノートのリソース、ノート作成ツール、保存済みノートを埋め込んで要約するプロンプトを提供し、MCPの仕組みを示します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
my-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": {
"my-server": {
"command": "/path/to/my-server/build/index.js"
}
}
}
デバッグ
MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。MCP Inspector の使用をおすすめします。これはパッケージスクリプトとして利用できます。
npm run inspector
Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。