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