Non Dirty MCP Client And Server

🚀 MCP クライアントとサーバー

モデルコンテキストプロトコルのクライアントとサーバーは、クライアントとサーバーを連鎖的に接続するために使用されます。

✨ 主な機能

リソース

サーバーは、以下の機能を備えたシンプルなノート保存システムを実装しています。

• 単一のノートにアクセスするためのカスタム note:// URI スキーム
• 各ノートリソースには、名前、説明、および text/plain MIME タイプがあります。

プロンプト

サーバーは以下のプロンプトを提供します。

• summarize-notes：保存されているすべてのノートの要約を生成します。
  • 詳細度を制御するためのオプションの「スタイル」パラメーター（簡潔/詳細）
  • スタイルの好みに基づいて、現在のすべてのノート内容を含むプロンプトを生成します。

ツール

サーバーは以下のツールを実装しています。

• add-note：サーバーに新しいノートを追加します。
  • 「名前」と「内容」を必須の文字列パラメーターとして受け取ります。
  • サーバーの状態を更新し、クライアントにリソースの変更を通知します。

📦 インストール

クイックスタート

MacOS でのインストール：

~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows でのインストール：

%APPDATA%/Claude/claude_desktop_config.json

💻 使用例

ビルドと公開

配布パッケージを準備するには、以下の手順を実行します。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージのリリースバージョンをビルドします。

uv build

これにより、dist/ ディレクトリにソースコードとホイール配布物が作成されます。

3. PyPI に公開します。

uv publish

注意: PyPI の認証情報は、環境変数またはコマンドライン引数で設定する必要があります。

• トークン: --token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード: --username/UV_PUBLISH_USERNAME および --password/UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは標準入出力で動作するため、デバッグが難しい場合があります。最適なデバッグ体験を得るために、MCP インスペクター の使用を強くおすすめします。

以下のコマンドで MCP インスペクターを起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/mlrsmith/Library/Mobile Documents/com~apple~CloudDocs/Family_Shared/AI/mcp/mcp-client-and-server run mcp-client-and-server

起動後、インスペクターはブラウザーに URL を表示し、そこでデバッグを開始できます。